DSOP Bankruptcy Notice: API documentation

 

:Version 1.0.0

 Services in API

HTTP-verb

Endepunkt

Beskrivelse

GET

/

Root. List links to the other services.

GET

/konkursvarsler

Retrieve all bankruptcy notices.

GET

/konkursvarsler/{uuid}

Retrieve the bankruptcy notice of the UUID of a unit.

GET

/konkursvarsler/oppdatert/{registreringstidspunkt}

Retrieve bankruptcy notices after a given registration time.

List of code

Bankruptcy Basis

Konkursgrunnlag

Beskrivelse

B

Request for Bankruptcy Opening

O

Bankruptcy opening Invitations

T

Forced settlement, Forced dissolution

Liquidation Code

Avviklingskode

Beskrivelse

TVDL

Forced dissolution due to lack of CEO

TVRE

Forced dissolution due to lack of auditor  

TVRR

Forced dissolution due to missing submitted annual report

TVST

Forced dissolution due to lack of board of directors

TVBA

Forced dissolution when the organization form BA (limited liability company) has not reported conversion to SA (cooperative enterprise)

TVOV

Forced discontinued as the company has signed the final resolution to the Register within one year from the announcement of the dissolution

 

 

Retrieve all bankruptcy notices

This method retrieves all bankruptcy notices.

HTTP request

HTTP

GET /konkursvarsler HTTP/1.1

Host: konkursvarsel.ppe-vcert.brreg.no

 

 

HTTP response

 

HTTP/1.1 200 OK

Content-Type: application/json;charset=UTF-8

Content-Length: 2580

 

{

  "_embedded" : {

    "konkursvarsler" : [ {

      "uuid" : "385fad87-b3e1-4542-a5ac-86c1b4e130af",

      "type" : "aapning",

      "registreringstidspunkt" : "2018-06-08T11:34:23.111Z",

      "kjennelsesdato" : "2018-06-08",

      "debitor" : "910425463",

      "_links" : {

        "self" : {

          "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler/385fad87-b3e1-4542-a5ac-86c1b4e130af"

        }

      }

    }, {

      "uuid" : "6d9dde1d-3e0b-4658-b483-0fd1361c888b",

      "type" : "oppheving",

      "registreringstidspunkt" : "2018-07-08T11:54:23.222Z",       "kjennelsesdato" : "2018-07-08",

      "aapningsId" : "385fad87-b3e1-4542-a5ac-86c1b4e130af",

      "debitor" : "910425463",

      "_links" : {

        "self" : {

          "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler/6d9dde1d-3e0b-4658-b483-0fd1361c888b"

        }

      }

    }, {

      "uuid" : "3988b863-0cb0-4ef6-ba60-e9dde47b780e",

      "type" : "aapning",

      "registreringstidspunkt" : "2018-10-10T11:54:23.333Z",

      "kjennelsesdato" : "2018-10-10",

      "debitor" : "19020101140",

      "innehaverAv" : [ "[910313851]" ],

      "_links" : {

        "self" : {

          "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler/3988b863-0cb0-4ef6-ba60-e9dde47b780e"

        }

      }

    }, {

      "uuid" : "a078977e-40b3-4da0-8c85-2e25c0b654ec",

      "type" : "sletting",

      "registreringstidspunkt" : "2018-10-10T12:54:23.333Z",       "kjennelsesdato" : "2018-10-10",

      "aapningsId" : "3988b863-0cb0-4ef6-ba60-e9dde47b780e",

      "debitor" : "19020101140",

      "innehaverAv" : [ "[910313851]" ],

      "_links" : {

        "self" : {

          "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler/a078977e-40b3-4da0-8c85-2e25c0b654ec"

        }

      }

    } ]

  },

  "_links" : {

    "first" : {

      "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler?page=0&size=2&sort=registreringstidspunkt,asc"

    },

    "self" : {

      "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler?page=0&size=2&sort=registreringstidspunkt,asc"

    },

    "next" : {

      "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler?page=1&size=2&sort=registreringstidspunkt,asc"

    },

    "last" : {

      "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler?page=1&size=2&sort=registreringstidspunkt,asc"

    }

  },

  "page" : {

    "size" : 2,

    "totalElements" : 3,

    "totalPages" : 2,

    "number" : 0

  }

}

 

 

 

 

 

Response fields

Path

Type

Description

_embedded.konkursvarsler.[].uuid

String

Unique ID for the bankruptcy notice, can be used to look up the bankruptcy notice

_embedded.konkursvarsler.[].type

String

Describes the type of bankruptcy notice this is:

commencement, cancellation or deletion

 

Path

Type

Description

_embedded.konkursvarsler.

[].registreringstidspunkt

String

Date (ISO-8601): YYYY-MM-

DDThh:mm:ss.sssZ. Time of registration in

Konkursregisteret (the Bankruptcy Register)

_embedded.konkursvarsler.

[].kjennelsesdato

String

Date (ISO-8601): YYYY-MM-DD. Date of verdict of the commencement

_embedded.konkursvarsler.

[].aapningsId

String

If deletion or cancellation, uuid referring to the commencement of the bankruptcy notice

_embedded.konkursvarsler.[].debitor

String

Debtor's company registration number/birth number/D no.

_embedded.konkursvarsler.

[].innehaverAv

Array

If the debtor is a person, a list of units the person is a holder of may be units of

the type ENK and TVAM

_embedded.konkursvarsler.

[]._links.self.href

String

Link with additional information about the commencement

_links.first.href

String

Link referring to the first page

_links.self.href

String

Link referring to this page

_links.next.href

String

Link referring to the next page

_links.last.href

String

Link referring to the last page

page.size

Number

Number of notices on this page

page.totalElements

Number

Total number of notices

page.totalPages

Number

Number of pages

page.number

Number

Page number of the current page


 

Retrieve the bankruptcy notice of the UUID of a unit

 

This method returns the bankruptcy notice for the UUID you want to look up.

 

HTTP request

GET /konkursvarsler/a16b65d3-f5de-46aa-8367-71c07f19ff0e HTTP/1.1

Accept: application/json

Host: konkursvarsel.ppe-vcert.brreg.no

 

 

Path parameters

Table 1. /konkursvarsler/{uuid}

Parameter

Description

uuid

uuid for the bankruptcy notice

 

 

 

Table 1. /konkursvarsler/{uuid}

Parameter            Description

uuid

 

uuid til konkursvarslet

 

HTTP response

  

HTTP/1.1 200 OK

Content-Type: application/json;charset=UTF-8

Content-Length: 1548

 

{

  "uuid" : "a16b65d3-f5de-46aa-8367-71c07f19ff0e",

  "type" : "oppheving",

  "registreringstidspunkt" : "2018-07-08T11:54:23.222Z",

  "kjennelsesdato" : "2018-07-08",

  "aapningsId" : "25ee3abd-a9aa-4955-bbb3-c9b9ac475a49",

  "konkursbonr" : "920966314",

  "konkursgrunnlag" : "O",

  "fristdag" : "2017-03-04",

  "fordringsfrist" : "2017-03-04",

  "saksnr" : "654764374",

  "debitor" : {

    "navn" : "Din Frisør SA ",

    "adresse" : {

      "postnummer" : "7092",

      "poststed" : "Tiller",

      "gateadresse" : "Julianus 20",

      "kommune" : "Trondheim",

      "kommunenummer" : "5001",

      "land" : "Norge",

      "landkode" : "NO"

    },

    "orgnr" : "910425463"

  },

  "tingrett" : {

    "organisasjonsnr" : "999999999",

    "navn" : "Nedre Romerike tingrett"

  },

  "skiftesamling" : {

    "avholdes" : "2018-09-08T09:40:00Z",

    "sted" : "Nedre Romerike tingrett, møterom  106, 1.etasje, Jonas Lies gate 20, Lillestrøm "

  },

  "bostyrer" : {

    "tittel" : "ADV",

    "navn" : "Kaisa Wagle",

    "telefon" : "11111111",

    "telefax" : "22222222",

    "epost" : "aaaa@brreg.no",

    "adresse" : {

      "postnummer" : "2000",

      "poststed" : "Lillestrøm",

      "gateadresse" : "Storgata 36",

      "kommune" : "Lillestrøm",

      "kommunenummer" : "3030",

      "land" : "Norge",

      "landkode" : "NO"

    }

  },

  "_links" : {

    "self" : {

      "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler/a16b65d3-f5de-46aa-8367-71c07f19ff0e"

    }

  }

}  

 

 

 

 

 

 

Response fields

 

Path

Type

Description

uuid

String

Unique ID for the bankruptcy notice

type

String

Describes the type of bankruptcy notice this is:

commencement, cancellation or deletion

registreringstidspunkt

String

Date (ISO-8601): YYYY-MM-

DDThh:mm:ss.sssZ. Time of registration in

Konkursregisteret (the Bankruptcy Register)

kjennelsesdato

String

Date (ISO-8601): YYYY-MM-DD. Date of verdict of commencement

konkursbonr

String

ID for the bankruptcy estate

konkursgrunnlag

String

Describes the basis for the commencement

avviklingskode

String

Liquidation code for commencement

fristdag

String

Date (ISO-8601): YYYY-MM-DD. Deadline for commencement

fordringsfrist

String

Date (ISO-8601): YYYY-MM-DD.

Claims deadline for commencement

saksnr

String

Case no. for the district court

debitor.navn

String

The name of the debtor, who may be a company or a person

debitor.fnr

String

Birth number of the debtor

debitor.innehaverAv

Array

Units held by the debtor

debitor.adresse.postnummer

String

The debtor's post code

debitor.adresse.poststed

String

The debtor's postal town

debitor.adresse.gateadresse

String

The debtor's address

debitor.adresse.kommune

String

The municipality the address is registered to

debitor.adresse.kommunenummer

String

The municipality's municipality number

debitor.adresse.land

String

The country address is located in

debitor.adresse.landkode

String

The country's country code

tingrett.organisasjonsnr

String

The district court's company registration number

tingrett.navn

String

The district court's name

skiftesamling.avholdes

String

Date (ISO-8601): YYYY-MMDDThh:mm:ssZ. The time for the creditors' meeting

skiftesamling.sted

String

Place for the creditors' meeting

bostyrer.tittel

String

Title of trustee in bankruptcy

bostyrer.navn

String

The name of the trustee in bankruptcy

bostyrer.telefon

String

The telephone number of the trustee in bankruptcy

bostyrer.telefax

String

The fax number of the trustee in bankruptcy

bostyrer.epost

String

The email address of the trustee in bankruptcy

bostyrer.adresse.postnummer

String

The post code of the trustee in bankruptcy

bostyrer.adresse.poststed

String

The postal town of the trustee in bankruptcy

bostyrer.adresse.gateadresse

String

The address of the trustee in bankruptcy

 

 

bostyrer.adresse.kommune

String

The municipality of the trustee in bankruptcy

bostyrer.adresse.kommunenummer

String

The municipality's municipality number

bostyrer.adresse.land

String

The country address is in

bostyrer.adresse.landkode

String

The country's country code

_links.self.href

String

Link for this bankruptcy notice


 

Retrieve the bankruptcy notice of the UUID of a person

This method returns the bankruptcy notice of the UUID you want to look up.

HTTP request

HTTP

GET /konkursvarsler/b3cb675f-0b13-4664-8a92-0b6120015b4c HTTP/1.1

Accept: application/json

Host: konkursvarsel.ppe-vcert.brreg.no

Path parameters

Table 1. /konkursvarsler/{uuid}

Parameter

Description

uuid

uuid for the bankruptcy notice

HTTP response

HTTP

HTTP/1.1 200 OK

Content-Type: application/json;charset=UTF-8

Content-Length: 1534

 

{

  "uuid" : "f6a95bde-420e-41a1-9dd3-4157af0b6da7",

  "type" : "aapning",

  "registreringstidspunkt" : "2018-10-10T11:54:23.333Z",

  "kjennelsesdato" : "2018-10-10",

  "konkursbonr" : "5467546",

  "konkursgrunnlag" : "T",

  "avviklingskode" : "TVRE",

  "fristdag" : "2017-03-04",

  "fordringsfrist" : "2017-03-04",

  "saksnr" : "654764374",

  "debitor" : {

    "navn" : "Cornelius Fosshaug",

    "adresse" : {

      "postnummer" : "7041",

      "poststed" : "Trondheim",

      "gateadresse" : "Julius veg 24",

      "kommune" : "Trondheim",

      "kommunenummer" : "5001",

      "land" : "Norge",

      "landkode" : "NO"

    },

    "fnr" : "19020101140",

    "innehaverAv" : [ "910313851" ]

  },

  "tingrett" : {

    "organisasjonsnr" : "974737418",

    "navn" : "Bergen tingrett"

  },

  "skiftesamling" : {

    "avholdes" : "2018-10-18T11:40:00Z",

    "sted" : "Oslo byfogdembete, rettssal 621, Oslo tinghus, C.J. Hambrosplass 4, 0031 Oslo"

  },

  "bostyrer" : {

    "tittel" : "ADV",

    "navn" : "Mads Næss",

    "telefon" : "33333333",

    "telefax" : "44444444",

    "epost" : "bbbb@brreg.no",

    "adresse" : {

      "postnummer" : "0032",

      "poststed" : "Oslo",

      "gateadresse" : "Osloveien 4",

      "kommune" : "Oslo",

      "kommunenummer" : "0301",

      "land" : "Norge",

      "landkode" : "NO"

    }

  },

  "_links" : {

    "self" : {

      "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler/f6a95bde-420e-41a1-9dd3-4157af0b6da7"

    }

  }

 

 

 

  

 

Response fields

 

Path

Type

Description

uuid

String

Unique ID for the bankruptcy notice

type

String

Describes the type of bankruptcy notice this is:

commencement, cancellation or deletion

registreringstidspunkt

String

Date (ISO-8601): YYYY-MM-

DDThh:mm:ss.sssZ. Time of registration in

Konkursregisteret (the Bankruptcy Register)

kjennelsesdato

String

Date (ISO-8601): YYYY-MM-DD. Date of verdict of commencement

aapningsId

String

If deletion or cancellation, uuid referred to the opening of the bankruptcy notification

konkursbonr

String

ID for the bankruptcy estate

konkursgrunnlag

String

Describes the basis for the commencement

avviklingskode

String

Only if “konkursgrunnlag” is T

fristdag

String

Date (ISO-8601): YYYY-MM-DD. Deadline for commencement

fordringsfrist

String

Date (ISO-8601): YYYY-MM-DD.

Claims deadline for commencement

saksnr

String

Case no. for the District Court

debitor.navn

String

The name of the debtor, who may be a company or a person

debitor.adresse.postnummer

String

The debtor's post code

debitor.adresse.poststed

String

The debtor's postal town

debitor.adresse.gateadresse

String

The debtor's address

debitor.adresse.kommune

String

The municipality the address is registered to

debitor.adresse.kommunenummer

String

The municipality's municipality number

debitor.adresse.land

String

The country address is located in

debitor.adresse.landkode

String

The country's country code

debitor.orgnr

String

Debtor's company registration number

tingrett.organisasjonsnr

String

The district court's company registration number

tingrett.navn

String

The district court's name

skiftesamling.avholdes

String

The time for the creditors' meeting

skiftesamling.sted

String

Place for the creditors' meeting

bostyrer.tittel

String

Title of trustee in bankruptcy

bostyrer.navn

String

The name of the trustee in bankruptcy

bostyrer.telefon

String

The telephone number of the trustee in bankruptcy

bostyrer.telefax

String

The fax number of the trustee in bankruptcy

bostyrer.epost

String

The email address of the trustee in bankruptcy

bostyrer.adresse.postnummer

String

The post code of the trustee in bankruptcy

bostyrer.adresse.poststed

String

The postal town of the trustee in bankruptcy

bostyrer.adresse.gateadresse

String

The address of the trustee in bankruptcy

bostyrer.adresse.kommune

String

The municipality of the trustee in bankruptcy

 

 

bostyrer.adresse.kommunenummer

String

The municipality's municipality number

bostyrer.adresse.land

String

The country address is in

bostyrer.adresse.landkode

String

The country's country code

_links.self.href

String

Link for this bankruptcy notice


 

Retrieve bankruptcy notices after a given registration time

This method retrieves all bankruptcy notices after a given registration time. The method takes the time of registration as a parameter, and retrieves bankruptcy notices where registration is performed after the given time.

 

Publication of the bankruptcy notice will occur after the registration time. To ensure that all bankruptcy notices are included, the last

NOTE registration time should be used for the next request.

 

 

 

HTTP request

HTTP

GET /konkursvarsler/oppdatert/2018-07-08T11:54:23.222Z HTTP/1.1

Accept: application/json

Host: konkursvarsel.ppe-vcert.brreg.no

 

Path parameters

Table 1. /konkursvarsler/oppdatert/{registreringstidspunkt}

Parameter

Description

registration time

Time of registration in Konkursregisteret (the Bankruptcy Register)

HTTP response

HTTP

HTTP/1.1 200 OK

Content-Disposition: inline;filename=f.txt

Content-Type: application/json;charset=UTF-8

Content-Length: 1314

 

{

  "_embedded" : {

    "konkursvarsler" : [ {

      "uuid" : "32282b0c-1490-441c-8fae-c003c644b6ef",

      "type" : "aapning",

      "registreringstidspunkt" : "2018-10-10T11:54:23.333Z",

      "kjennelsesdato" : "2018-10-10",

      "debitor" : "19020101140",

      "innehaverAv" : [ "[910313851]" ],

      "_links" : {

        "self" : {

          "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler/32282b0c-1490-441c-8fae-c003c644b6ef"

        }

      }

    }, {

      "uuid" : "ebe34188-1a1a-4e95-a145-d75676f77d62",

      "type" : "sletting",

      "registreringstidspunkt" : "2018-10-10T12:54:23.333Z",

      "kjennelsesdato" : "2018-10-10",

      "aapningsId" : "32282b0c-1490-441c-8fae-c003c644b6ef",

      "debitor" : "19020101140",

      "innehaverAv" : [ "[910313851]" ],

      "_links" : {

        "self" : {

          "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler/ebe34188-1a1a-4e95-a145-d75676f77d62"

        }

      }

    } ]

  },

  "_links" : {

    "self" : {

      "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler/oppdatert/2018-07-08T11:54:23.222Z?page=0&size=1&sort=registreringstidspunkt,asc"

    }

  },

  "page" : {

    "size" : 1,

    "totalElements" : 1,

    "totalPages" : 1,

    "number" : 0

  }

 

 

 

 

 

 

Response fields

Path

Type

Description

_embedded.konkursvarsler.[].uuid

String

Unique ID for the bankruptcy notice, can be used to look up the bankruptcy notice

 

 

_embedded.konkursvarsler.[].type

String

Describes the type of bankruptcy notice this is:

commencement, cancellation or deletion

_embedded.konkursvarsler.

[].registreringstidspunkt

String

Date (ISO-8601): YYYY-MM-

DDThh:mm:ss.sssZ. Time of registration in

Konkursregisteret (the Bankruptcy Register)

_embedded.konkursvarsler.

[].kjennelsesdato

String

Date (ISO-8601): YYYY-MM-DD. Date of verdict of the commencement

_embedded.konkursvarsler.[].aapningsId

 

 

String

 

If deletion or cancellation, uuid referred to the opening of the bankruptcy notification

_embedded.konkursvarsler.[].debitor

String

Debtor's company registration number/birth number/D no.

_embedded.konkursvarsler.

[].innehaverAv

Array

If the debtor is a person, a list of units the person is a holder of may be units of

the type ENK and TVAM

_embedded.konkursvarsler.

[]._links.self.href

String

Link with additional information about the commencement

_links.self.href

String

Link referring to this page

page.size

Number

Number of notices on this page

page.totalElements

Number

Total number of notices

page.totalPages

Number

Number of pages on this link

page.number

Number

Page number of the current page


 

Mishandling of registration time

This response is given when an incorrect format is entered for the registration time at filtering.

 

HTTP request

HTTP

GET /konkursvarsler/oppdatert/2018-11-06T09:15:50.840 HTTP/1.1

Accept: application/json

Host: konkursvarsel.ppe-vcert.brreg.no

 

HTTP response

HTTP

HTTP/1.1 400 Bad Request

Content-Type: application/json;charset=UTF-8

Content-Length: 146

 

{

  "status" : 400,

  "error" : "Bad Request",

  "message" : "Registreringstidspunkt må være på dette formatet: yyyy-MM-ddTHH:mm:SS.sssZ" }

 

Response fields

Path

Type

Description

status

Number

HTTP error code status

error

String

HTTP error code description

message

String

Supplementary description of the error response


 

Mishandling of UUID

This response is given when searching for a UUID that does not exist.

 

HTTP request

HTTP

GET /konkursvarsler/hghxfcth HTTP/1.1 Accept: application/json

Host: konkursvarsel.ppe-vcert.brreg.no

HTTP response

HTTP

HTTP/1.1 404 Not Found

Content-Type: application/json;charset=UTF-8

Content-Length: 85

 

{

  "status" : 404,

  "error" : "Not Found",

  "message" : "UUIDen finnes ikke"

}

Response fields

Path

Type

Description

status

Number

HTTP error code status

error

String

HTTP error code description

message

String

Supplementary description of the error response


 

Pagination

It is possible to filter and browse the result set using page+size and registration time as parameters. Page+size may have some limitations on filtering if a large number of bankruptcy notices is reached.

For example, size may be set to 10 if this page size is desired. This is done by a request on bankruptcy notices?page=0&size=10. Then, 10 is the size of each page, and the pages can be browsed or filtered by setting the page to the desired page number. The maximum page size is 2000, i.e. size=2000.

We recommend using page+size to navigate, while time is used to filter the desired display of bankruptcy notices.

Security mechanisms

Information about necessary security mechanisms: authentication and authorisation.

 

Authentication

To use the service, an X.509 (https://en.wikipedia.org/wiki/X.509) enterprise certificate from a registered provider is required. The national communication authority has an overview of the providers.

(https://www.nkom.no/teknisk/tillitstjenester/selvdeklarasjon/registrerte-tilbydarar-av-sertifikat-etter-sj%C3%B8lvdeklarasjonsordninga)

 

 A test enterprise certificate must be used in test and a prod enterprise certificate in prod

 

The personal key (https://no.wikipedia.org/wiki/Digitalt_sertifikat#Offentlig_og_privat_n%C3%B8kkel) for the certificate is needed. Your personal key should never be shared with anyone.

Only main units may be issued with an enterprise certificate. This means that a sub-unit wanting to look up

NOTE bankruptcy notices have to use the enterprise certificate for the main unit.

 

Authorisation

The service authorises access to bankruptcy notices based on the company registration number on the enterprise certificate.

 

Authorisation with company registration number

The access to bankruptcy notices is administered by Konkursregisteret (the Bankruptcy Register)

 

Setup of firewall

If the service is called from behind an outgoing firewall, openings must be created in the firewall.

Environment

Host

IP

Port

Preprod (PPE)

*.ppe-vcert.brreg.no

195.43.63.219

443

Production (PRD)

*.vcert.brreg.no

195.43.63.220

443

 

REST client certificate authentication

Standard client certificate authentication is required. Most common HTTP tools support this. Example with curl:

 

$ curl -k -v --cert virksomhet.cer --key virksomhet.key "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler" > resultat.json