DSOP Bankruptcy Notice: API documentation

:Versjon 1.1.0

Services in API

HTTP-verb

Endpoint

Description

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.

 

Endpoints in test and production environment

Environment

Endpoint

IP

Test

https://konkursvarsel.ppe-vcert.brreg.no

195.43.63.219

Production

https://konkursvarsel.vcert.brreg.no

195.43.63.220

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.1
Host: konkursvarsel.ppe-vcert.brreg.no

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-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

_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:

_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.[].innstillingsdato

String

The expiration date of the bankruptcy, forced or compulsory compulsory dissolution

_embedded.konkursvarsler.[].aapningsId

String

If deletion, cancellation or termination, uuid referring to the opening 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

_embedded.konkursvarsler.[]._links.self.href

String

the type ENK and TVAM

_links.first.href

String

Link with additional information about the commencement

_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 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/json
Host: konkursvarsel.ppe-vcert.brreg.no

Path parameters

Table 1. /konkursvarsler/{uuid}

Parameter

Description

uuid

uuid for the bankruptcy notice

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-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

Uuid

String

Unik id til konkursvarslet

Type

String

Beskriver hvilken type konkursvarsel dette er : aapning, oppheving, sletting eller avslutning

registreringstidspunkt

String

Dato (ISO-8601): YYYY-MM-DDThh:mm:ss.sssZ. Tidspunkt for registrering i Konkursregisteret

kjennelsesdato

String

Dato (ISO-8601): YYYY-MM-DD. Dato for kjennelse av åpning

konkursbonr

String

Unique ID for the bankruptcy notice

konkursgrunnlag

String

Describes the type of bankruptcy notice

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.fnr

String

national identity number of the debtor

debitor.innehaverAv

Array

Entities owned 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

Dato (ISO-8601): YYYY-MM-DDThh: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

Kommunenummeret til kommunen

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 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/json
Host: konkursvarsel.ppe-vcert.brreg.no

Path parameters

Table 1. /konkursvarsler/{uuid}

Parameter

Description

uuid

uuid for the bankruptcy notice

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-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

uuid

String

Unique ID for the bankruptcy notice

type

String

Describes the type of bankruptcy notice this is:

registreringstidspunkt

String

Date (ISO-8601): YYYY-MM-

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

Konkursregisteret (the Bankruptcy Register)

kjennelsesdato

String

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

innstillingsdato

String

Dato (ISO-8601): YYYY-MM-DD.  Setting date for the bankruptcy, compulsory liquidation or compulsory dissolution.

aapningsId

String

if «sletting» or «oppheving» the  uuid that refers to the opening of the bankruptcy

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.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

The registration number to the debtor

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 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.1
Accept: application/json
Host: konkursvarsel.ppe-vcert.brreg.no

Path parameters

Table 1. /konkursvarsler/oppdatert/{registreringstidspunkt}

Parameter

Description

registreringstidspunkt

Time of registration in Konkursregisteret (the Bankruptcy Register)

HTTP response

HTTP/1.1 200 OK
Content-Disposition: inline;filename=f.txt
Content-Type: application/json;charset=UTF-8
Content-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

_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.[].innstillingsdato

String

The expiration date of the bankruptcy, forced or compulsory compulsory dissolution

_embedded.konkursvarsler.[].aapningsId

String

If deletion, cancellation or termination, uuid referring to the opening 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

_embedded.konkursvarsler.[]._links.self.href

String

the type ENK and TVAM

_links.self.href

String

Link with additional information about the commencement

page.size

Number

Link referring to this page

page.totalElements

Number

Number of notices on this page

page.totalPages

Number

Total number of notices

page.number

Number

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.1
Accept: application/json
Host: konkursvarsel.ppe-vcert.brreg.no

HTTP response

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

GET /konkursvarsler/hghxfcth HTTP/1.1
Accept: application/json
Host: konkursvarsel.ppe-vcert.brreg.no

HTTP response

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 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