DSOP Bankruptcy Notice:
API documentation
:Version 1.0.0
HTTP-verb |
Endepunkt |
Beskrivelse |
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. |
Konkursgrunnlag |
Beskrivelse |
B |
Request for Bankruptcy
Opening |
O |
Bankruptcy opening Invitations |
T |
Forced settlement, Forced
dissolution |
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 |
This method retrieves all bankruptcy notices.
HTTP
GET /konkursvarsler HTTP/1.1
Host: konkursvarsel.ppe-vcert.brreg.no
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
}
}
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 |
This method returns the bankruptcy notice for the UUID you want to look
up.
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"
}
}
}
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 |
This method returns the bankruptcy notice of the UUID you want to look
up.
HTTP
GET /konkursvarsler/b3cb675f-0b13-4664-8a92-0b6120015b4c HTTP/1.1
Accept: application/json
Host: konkursvarsel.ppe-vcert.brreg.no
Parameter |
Description |
uuid |
uuid for the bankruptcy notice |
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"
}
}
}
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 |
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
GET /konkursvarsler/oppdatert/2018-07-08T11:54:23.222Z HTTP/1.1
Accept: application/json
Host: konkursvarsel.ppe-vcert.brreg.no
Parameter |
Description |
registration time |
Time of registration in Konkursregisteret (the
Bankruptcy Register) |
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
}
}
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 |
This response is given when an incorrect format is entered for the
registration time at filtering.
HTTP
GET /konkursvarsler/oppdatert/2018-11-06T09:15:50.840 HTTP/1.1
Accept: application/json
Host: konkursvarsel.ppe-vcert.brreg.no
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" }
Path |
Type |
Description |
status |
Number |
HTTP error code status |
error |
String |
HTTP error code description |
message |
String |
Supplementary description of the error response |
This response is given when searching for a UUID that does not exist.
HTTP
GET /konkursvarsler/hghxfcth HTTP/1.1 Accept: application/json
Host: konkursvarsel.ppe-vcert.brreg.no
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"
}
Path |
Type |
Description |
status |
Number |
HTTP error code status |
error |
String |
HTTP error code description |
message |
String |
Supplementary description of the error response |
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.
Information about necessary security mechanisms: authentication and
authorisation.
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.
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.
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)
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 |
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