:Versjon 1.1.0
Services in API
|
HTTP-verb |
Endpoint |
Description |
|
GET |
/ |
Root. List links to the other services. |
|
GET |
Retrieve all bankruptcy notices. |
|
|
GET |
Retrieve the bankruptcy notice of the UUID of a
unit. |
|
|
GET |
Retrieve bankruptcy notices after a given
registration time. |
Endpoints in test and
production environment
|
Environment |
Endpoint |
IP |
|
|
|
|
|
|
|
List of code
Type of bankruptcy
|
Bankruptcy |
Description |
|
aapning |
This applies to the commencement of bankruptcy,
compulsory liquidation or compulsory dissolution. |
|
oppheving |
This applies to a change as a result of an appeal to
a commencement, mentioned in aapning |
|
sletting |
A cancellation to a commencement mentioned in
aapning |
|
avslutning |
This applies to a closing of bankruptcy, compulsory liquidation or compulsory
dissolution. |
Bankruptcy Basis
|
Bankruptcy Basis |
Description |
|
B |
Request for Bankruptcy Opening |
|
O |
Bankruptcy opening Invitations |
|
T |
Forced settlement, Forced dissolution |
Liquidation Code
|
Liquidation Code |
Description |
|
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
GET /konkursvarsler HTTP/1.1Host: konkursvarsel.ppe-vcert.brreg.no
HTTP response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8Content-Length: 3491 { "_embedded" : { "konkursvarsler" : [ { "uuid" : "e41ce970-3687-4910-a705-744d0daae927", "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/e41ce970-3687-4910-a705-744d0daae927" } } }, { "uuid" : "e53364c5-3376-4e50-968b-2146e3656496", "type" : "oppheving", "registreringstidspunkt" : "2018-07-08T11:54:23.222Z", "kjennelsesdato" : "2018-07-08", "aapningsId" : "e41ce970-3687-4910-a705-744d0daae927","debitor" : "910425463",
"_links" : { "self" : { "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler/e53364c5-3376-4e50-968b-2146e3656496" } } }, { "uuid" : "d9d820de-67d9-4a92-9159-4a5223342cc9", "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/d9d820de-67d9-4a92-9159-4a5223342cc9"
} } }, { "uuid" : "00721098-efc7-4043-8ff4-883d4d06537e", "type" : "sletting", "registreringstidspunkt" : "2018-10-10T12:54:23.333Z", "kjennelsesdato" : "2018-10-10", "aapningsId" : "d9d820de-67d9-4a92-9159-4a5223342cc9", "debitor" : "19020101140", "innehaverAv" : [ "[910313851]" ], "_links" : { "self" : { "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler/00721098-efc7-4043-8ff4-883d4d06537e"}
} }, { "uuid" : "2bce3a21-f857-4e6a-ae46-576d178f1d0c", "type" : "aapning", "registreringstidspunkt" : "2018-07-09T11:34:23.111Z", "kjennelsesdato" : "2018-07-09", "debitor" : "910425463", "_links" : { "self" : { "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler/2bce3a21-f857-4e6a-ae46-576d178f1d0c"}
} }, { "uuid" : "fccfb49a-1cfa-4df1-a477-902765b9984c", "type" : "avslutning", "registreringstidspunkt" : "2018-08-09T11:34:23.111Z", "kjennelsesdato" : "2018-08-09", "innstillingsdato" : "2018-09-09", "aapningsId" : "2bce3a21-f857-4e6a-ae46-576d178f1d0c","debitor" : "910425463",
"_links" : { "self" : { "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler/fccfb49a-1cfa-4df1-a477-902765b9984c" } } } ] }, "_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 |
|
|
|
Unique ID for the bankruptcy notice, can be used to
look up the bankruptcy notice |
|
|
|
Describes the type of bankruptcy notice this is: |
|
|
|
Date (ISO-8601): YYYY-MM- DDThh:mm:ss.sssZ. Time of registration in Konkursregisteret (the Bankruptcy Register) |
|
|
|
Date (ISO-8601): YYYY-MM-DD. Date of verdict of the
commencement |
|
|
The
expiration date of the bankruptcy, forced or compulsory compulsory dissolution |
|
|
|
If
deletion, cancellation or termination, uuid referring to the opening of the
bankruptcy notice |
|
|
|
|
Debtor's company registration number/birth number/D
no. |
|
|
|
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 |
|
|
|
Link with additional information about the
commencement |
|
|
|
Link referring to this page |
|
|
|
Link
referring to the next page |
|
|
|
Link referring to the last page |
|
|
|
Number of notices on this page |
|
|
|
Total number of notices |
|
|
|
Number of pages |
|
|
|
Page number of the current page |
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
GET /konkursvarsler/a7bc5a28-a546-44ca-b38a-f977832322e0 HTTP/1.1
Accept: application/jsonHost: konkursvarsel.ppe-vcert.brreg.no
Path parameters
|
Table 1.
/konkursvarsler/{uuid} |
|
|
Parameter |
Description |
|
|
uuid for the bankruptcy notice |
HTTP response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8Content-Length: 1534 { "uuid" : "a7bc5a28-a546-44ca-b38a-f977832322e0", "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/a7bc5a28-a546-44ca-b38a-f977832322e0" } }}
Response fields
|
Path |
Type |
Description |
|
|
|
Unik id til konkursvarslet |
|
|
|
Beskriver hvilken type konkursvarsel dette er : aapning, oppheving, sletting eller avslutning |
|
|
|
Dato (ISO-8601): YYYY-MM-DDThh:mm:ss.sssZ. Tidspunkt for registrering i Konkursregisteret |
|
|
|
Dato (ISO-8601): YYYY-MM-DD. Dato for kjennelse av åpning |
|
|
|
Unique
ID for the bankruptcy notice |
|
|
|
Describes
the type of bankruptcy notice |
|
|
|
Only if “konkursgrunnlag” is T |
|
|
|
Date (ISO-8601): YYYY-MM-DD. Deadline for commencement |
|
|
|
Date (ISO-8601): YYYY-MM-DD. Claims deadline for commencement |
|
|
|
Case no. for the District Court |
|
|
|
The name of the debtor, who may be a company or a
person |
|
|
|
national identity number of the debtor |
|
|
|
Entities owned by the debtor |
|
|
|
The debtor's post code |
|
|
|
The debtor's postal town |
|
|
|
The debtor's address |
|
|
|
The municipality the address is registered to |
|
|
|
The municipality's municipality number |
|
|
|
The country address is located in |
|
|
|
The country's country code |
|
|
|
The district court's company registration number |
|
|
|
The district court's name |
|
|
|
Dato (ISO-8601): YYYY-MM-DDThh:mm:ssZ. The time for the creditors' meeting |
|
|
|
Place for the creditors' meeting |
|
|
|
Title of trustee in bankruptcy |
|
|
|
The name of the trustee in bankruptcy |
|
|
|
The telephone number of the trustee in bankruptcy |
|
|
|
The fax number of the trustee in bankruptcy |
|
|
|
The email address of the trustee in bankruptcy |
|
|
|
The post code of the trustee in bankruptcy |
|
|
|
The postal town of the trustee in bankruptcy |
|
|
|
The address of the trustee in bankruptcy |
|
|
|
The municipality of the trustee in bankruptcy |
|
|
|
Kommunenummeret til kommunen |
|
|
|
The country address is in |
|
|
|
The country's country code |
|
|
|
Link for this bankruptcy notice |
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/03520e68-3a8c-4352-a404-b115751c3808 HTTP/1.1
Accept: application/jsonHost: konkursvarsel.ppe-vcert.brreg.no
Path parameters
|
Table 1.
/konkursvarsler/{uuid} |
|
|
Parameter |
Description |
|
|
uuid for the bankruptcy notice |
HTTP
response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8Content-Length: 1589 { "uuid" : "03520e68-3a8c-4352-a404-b115751c3808", "type" : "avslutning", "registreringstidspunkt" : "2018-08-09T11:34:23.111Z", "kjennelsesdato" : "2018-08-09", "innstillingsdato" : "2018-09-09", "aapningsId" : "8dbf6392-1cbd-46a4-812f-abece9343c63", "konkursbonr" : "920955314", "konkursgrunnlag" : "T", "avviklingskode" : "TVRE", "fristdag" : "2018-07-10", "fordringsfrist" : "2018-07-10", "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" : "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/03520e68-3a8c-4352-a404-b115751c3808" } }}
Response fields
|
Path |
Type |
Description |
|
|
|
Unique ID for the bankruptcy notice |
|
|
|
Describes the type of bankruptcy notice this is: |
|
|
|
Date (ISO-8601): YYYY-MM- DDThh:mm:ss.sssZ. Time of registration in Konkursregisteret (the Bankruptcy Register) |
|
|
|
Dato (ISO-8601): YYYY-MM-DD. . Date of verdict of
commencement |
|
|
|
Dato (ISO-8601): YYYY-MM-DD. Setting date for the bankruptcy, compulsory
liquidation or compulsory dissolution. |
|
|
|
if «sletting» or «oppheving» the uuid that refers to the opening of the
bankruptcy |
|
|
|
ID for the bankruptcy estate |
|
|
|
Describes the basis for the commencement |
|
|
|
Liquidation code for commencement |
|
|
|
Date (ISO-8601): YYYY-MM-DD. Deadline for commencement |
|
|
|
Date (ISO-8601): YYYY-MM-DD. Claims deadline for commencement |
|
|
|
Case no. for the district court |
|
|
|
The name of the debtor, who may be a company or a
person |
|
|
|
The debtor's post code |
|
|
|
The debtor's postal town |
|
|
|
The debtor's address |
|
|
|
The municipality the address is registered to |
|
|
|
The municipality's municipality number |
|
|
|
The country address is located in |
|
|
|
The country's country code |
|
|
|
The registration number to the debtor |
|
|
|
The district court's company registration number |
|
|
|
The district court's name |
|
|
|
Date (ISO-8601): YYYY-MMDDThh:mm:ssZ. The time for
the creditors' meeting |
|
|
|
Place for the creditors' meeting |
|
|
|
Title of trustee in bankruptcy |
|
|
|
The name of the trustee in bankruptcy |
|
|
|
The telephone number of the trustee in bankruptcy |
|
|
|
The fax number of the trustee in bankruptcy |
|
|
|
The email address of the trustee in bankruptcy |
|
|
|
The post code of the trustee in bankruptcy |
|
|
|
The postal town of the trustee in bankruptcy |
|
|
|
The address of the trustee in bankruptcy |
|
|
|
The municipality of the trustee in bankruptcy |
|
|
|
The municipality's municipality number |
|
|
|
The country address is in |
|
|
|
The country's country code |
|
|
|
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.
|
Note |
Publication of the bankruptcy notice will occur after the registration
time. To ensure that all bankruptcy notices are included, the last
registration time should be used for the next request |
HTTP
request
GET /konkursvarsler/oppdatert/2018-07-08T11:54:23.222Z HTTP/1.1Accept: application/jsonHost: konkursvarsel.ppe-vcert.brreg.no
Path parameters
|
Table 1.
/konkursvarsler/oppdatert/{registreringstidspunkt} |
|
|
Parameter |
Description |
|
|
Time of registration in Konkursregisteret (the
Bankruptcy Register) |
HTTP response
HTTP/1.1 200 OK
Content-Disposition: inline;filename=f.txtContent-Type: application/json;charset=UTF-8Content-Length: 2225 { "_embedded" : { "konkursvarsler" : [ { "uuid" : "d6d0bc09-f0db-486f-bd31-b65c404e96cd", "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/d6d0bc09-f0db-486f-bd31-b65c404e96cd"
} } }, { "uuid" : "a6b31e1e-0991-4e7e-b85f-2cbf6665294a", "type" : "sletting", "registreringstidspunkt" : "2018-10-10T12:54:23.333Z", "kjennelsesdato" : "2018-10-10", "aapningsId" : "d6d0bc09-f0db-486f-bd31-b65c404e96cd", "debitor" : "19020101140", "innehaverAv" : [ "[910313851]" ], "_links" : { "self" : { "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler/a6b31e1e-0991-4e7e-b85f-2cbf6665294a"}
} }, { "uuid" : "02f3886a-a03b-4b4e-a250-b9447d158a58", "type" : "aapning", "registreringstidspunkt" : "2018-07-09T11:34:23.111Z", "kjennelsesdato" : "2018-07-09", "debitor" : "910425463", "_links" : { "self" : { "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler/02f3886a-a03b-4b4e-a250-b9447d158a58" } } }, { "uuid" : "ee01922b-ab6d-48f8-81c8-26dd9cc0dc42", "type" : "avslutning", "registreringstidspunkt" : "2018-08-09T11:34:23.111Z", "kjennelsesdato" : "2018-08-09", "innstillingsdato" : "2018-09-09", "aapningsId" : "02f3886a-a03b-4b4e-a250-b9447d158a58", "debitor" : "910425463", "_links" : { "self" : { "href" : "https://konkursvarsel.ppe-vcert.brreg.no/konkursvarsler/ee01922b-ab6d-48f8-81c8-26dd9cc0dc42" } } } ] }, "_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 |
|
|
|
Unique ID for the bankruptcy notice, can be used to
look up the bankruptcy notice |
|
|
|
Describes the type of bankruptcy notice this is: commencement, cancellation or deletion |
|
|
|
Date (ISO-8601): YYYY-MM- DDThh:mm:ss.sssZ. Time of registration in Konkursregisteret (the Bankruptcy Register) |
|
|
|
Date (ISO-8601): YYYY-MM-DD. Date of verdict of the
commencement |
|
|
|
The expiration date of the bankruptcy, forced or
compulsory compulsory dissolution |
|
|
|
If deletion, cancellation or termination, uuid
referring to the opening of the bankruptcy notice |
|
|
|
Debtor's company registration number/birth number/D
no. |
|
|
|
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 |
|
|
|
Link with additional information about the
commencement |
|
|
|
Link referring to this page |
|
|
|
Number of notices on this page |
|
|
|
Total
number of notices |
|
|
|
Number of pages on this link |
Mishandling of registration time
This response is given when an
incorrect format is entered for the registration time at filtering.
HTTP request
GET /konkursvarsler/oppdatert/2018-11-06T09:15:50.840 HTTP/1.1Accept: application/jsonHost: konkursvarsel.ppe-vcert.brreg.no
HTTP
response
HTTP/1.1 400 Bad Request
Content-Type: application/json;charset=UTF-8Content-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 |
|
|
|
HTTP error code status |
|
|
|
HTTP error code description |
|
|
|
Supplementary description of the error response |
This response is given when
searching for a UUID that does not exist.
HTTP request
GET /konkursvarsler/hghxfcth HTTP/1.1Accept: application/jsonHost: konkursvarsel.ppe-vcert.brreg.no
HTTP response
HTTP/1.1 404 Not Found
Content-Type: application/json;charset=UTF-8Content-Length: 85 { "status" : 404, "error" : "Not Found", "message" : "UUIDen finnes ikke"}
Response fields
|
Path |
Type |
Description |
|
|
|
HTTP error code status |
|
|
|
HTTP error code description |
|
|
|
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 enterprise certificate from a registered
provider is required. The national communication authority
has an overview of the providers.
·
A
test enterprise certificate must be used in test and a prod enterprise
certificate in prod
· The personal key for the certificate is needed. Your personal key should never be shared with anyone.
|
Note |
Det
er bare hovedenheter som kan få utstedt virksomhetssertifikat. Det betyr at
en underenhet som skal gjøre oppslag på konkursvarsler er nødt å bruke
virksomhetssertifikatet til hovedenheten. |
Authorization
The service authorises access to
bankruptcy notices based on the company registration number on the enterprise
certificate.
Authorization with company
registration number
The access to bankruptcy notices is
administered by Konkursregisteret (the Bankruptcy Register)
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