54 of 57 sources live 23 countries, Europe, North America and South Korea Last read Romania, 9 min ago 0 new cases today Status
insolvencyapi
Sign inGet an API key
Coverage 23 countries, Europe, North America and South Korea Documentation REST, JSON Status 54 of 57 sources live Labs New and experimental Pricing From free
Sign inGet an API key
Home/Documentation/Guides

Insolvency API guide

One shape for every country

A case is one company in one insolvency procedure, in the same shape for all 23 countries.

Every field

FieldTypeWhat it holds
idtextThe case id, cs_ followed by 8 characters.
countrytextOne of gb, fr, at, cz, ee, fi, hr, ie, lv, no, pt, ro, sk, es, se, pl, us, lt, de, ch, ua, si, kr.
companyobjectThe company in the case: register_number, name, town, postcode, sic, sector, register_status, nature_of_business.
proceduretextThe procedure, see /v1/vocabulary.
procedure_labeltextThe procedure in plain English.
statustextpetition, open, closing, closed or dismissed (open or closed outside the UK and France).
status_labeltextThe status in plain English.
petition_ondate, or nullWhen a winding-up petition was presented.
opened_ondate, or nullWhen the proceedings opened; where opened_precision is window, the day by which they had opened.
opened_afterdate, or nullWhere opened_precision is window: the day before which they had not opened.
opened_precisiontextday, or window where a country's records date a start only to a month-long window.
closed_ondate, or nullWhen the proceedings closed or a petition was dismissed.
closed_bytext, or nullWhat closed it: notice, conversion (a French reorganisation or safeguard converted into liquidation) or register (the register shows the company dissolved or ceased).
claims_deadlinedate, or nullThe last day creditors can send their claims (UK and France, paid plans).
next_hearingobject, or nullA pending petition's next hearing: date, local_time, timezone, where published (paid plans).
last_hearingobject, or nullThe latest hearing any of the case's notices set, past or still ahead, in the same shape (paid plans).
courttext, or nullThe court (paid plans).
court_case_reftext, or nullThe court's case number, where the country publishes one (paid plans).
first_notice_ondate, or nullThe first notice held for the case (UK and France).
last_notice_ondate, or nullThe latest notice held for the case (UK and France).
notice_countnumberNotices held for the case.
last_activity_ondateThe case's latest step: what lists are ordered by.
Company data only. Sole traders are counted in statistics but never listed, and no person is ever named.

The company in a case

Fields marked paid plans are null on Developer. Town, postcode and sector are given in the UK and France. The court’s case number comes in 14 of the 23 countries.

FieldTypeWhat it holds
company.register_numbertext, or nullThe company's number in its country's register (UK company number, French SIREN and the like); null for a US court case found by the debtor's name.
company.nametextThe company's name as published.
company.towntext, or nullRegistered office town (UK and France, paid plans).
company.postcodetext, or nullRegistered office postcode (UK and France, paid plans).
company.sictext, or nullMain activity code: UK SIC 2007, or French NAF rev. 2 (paid plans).
company.sectorobject, or nullThe activity's section, the same 21 for both countries: code (A to U) and label (UK and France, paid plans).
company.register_statustext, or nullStatus on the national company register, as the register words it (paid plans).
company.nature_of_businesstext, or nullWhat the company did, as published (paid plans).

A case, in full

A real case from this morning’s data.

Example answerCopy
{
  "data": {
    "id": "cs_k54b7nzt",
    "country": "gb",
    "company": {
      "register_number": "04542915",
      "name": "KMJ VENTILATION LIMITED",
      "town": "WORCESTERSHIRE",
      "postcode": "WR9 7DQ",
      "sic": "43220",
      "sector": {
        "code": "F",
        "label": "Construction"
      },
      "register_status": "Active",
      "nature_of_business": null
    },
    "procedure": "members_voluntary_liquidation",
    "procedure_label": "Members' voluntary liquidation",
    "status": "open",
    "status_label": "Proceedings are open",
    "petition_on": null,
    "opened_on": "2026-10-30",
    "opened_after": null,
    "opened_precision": "day",
    "closed_on": null,
    "closed_by": null,
    "claims_deadline": null,
    "next_hearing": null,
    "last_hearing": null,
    "court": null,
    "court_case_ref": null,
    "first_notice_on": "2026-10-30",
    "last_notice_on": "2026-10-30",
    "notice_count": 3,
    "last_activity_on": "2026-10-30"
  },
  "meta": {}
}