Home/Documentation/Cases

Insolvency API cases

Find cases

Every case held in 18 countries, newest activity first, filtered any way you like.

Every planMCP tool: find_cases

The call

Every case held in 18 countries, newest activity first, filtered any way you like.

GEThttps://api.insolvencyapi.com/v1/cases

Try it

Your keyGet a free key

Kept in this browser and filled in on every documentation page.

country

procedure

status

opened_from

opened_to

updated_since

sector

claims_open

register_number

postcode

limit

Calls the API from this browser with your key.

curl PHP Python JavaScriptCopy

Code, built from the form

The answer

Parameters

NameTypeNeededWhat it does

countrylistOptionalOne or more countries, comma separated.gbfratczeefihrielvnoptroskesseplusltdechuasikr

procedurelistOptionalOne or more procedures, see /v1/vocabulary.compulsory_liquidationcreditors_voluntary_liquidationmembers_voluntary_liquidationadministrationadministrative_receivershipreceivershipmoratoriumjudicial_liquidationjudicial_reorganisationsafeguardconciliationotherbankruptcyinsolvencyliquidationliquidation_unspecifiedrestructuringforced_dissolutionexternal_administration

statuslistOptionalpetition, open, closing, closed or dismissed.petitionopenclosingcloseddismissed

opened_fromdateOptionalProceedings opened on or after.

opened_todateOptionalProceedings opened on or before.

updated_sincedateOptionalOnly cases with something new on or after this day.

sectorlistOptionalOne or more sector sections, A to U, see /v1/vocabulary (UK and France).ABCDEFGHIJKLMNOPQRSTU

claims_opentrue or falseOptionaltrue for cases still taking creditors' claims (UK and France).truefalse

register_numbertextOptionalOne company, by its number in its country's register (needs one country).

postcodetextOptionalRegistered office postcode, or the start of one (UK and France).

qtextOptionalPart of the company name, 3 characters or more.

limitnumberOptionalResults a page: 25 if left out, up to 100 on paid plans and 25 on Developer.

pagenumberOptionalThe page, from 1.

cursortextOptionalThe next_cursor from the page before.

What comes back

A list in data, each item with these fields, the same in every country. Paging and counts are in meta; see Pagination.

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.

An example answer

A real answer from this morning’s data, made by the call Try it opens on.

Example answerCopy

{
  "data": [
    {
      "id": "cs_5z3tyna7",
      "country": "gb",
      "company": {
        "register_number": "10144457",
        "name": "BOLD STRIPE SOLUTIONS LIMITED",
        "town": "BIRMINGHAM",
        "postcode": "B4 6EQ",
        "sic": "70229",
        "sector": {
          "code": "M",
          "label": "Professional, scientific and technical activities"
        },
        "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": 2,
      "last_activity_on": "2026-10-30"
    },
    {
      "id": "cs_7tacdyz0",
      "country": "gb",
      "company": {
        "register_number": "08539599",
        "name": "FORT AMHERST HALLOWEEN LIMITED",
        "town": "CHATHAM",
        "postcode": "ME4 4UB",
        "sic": "91030",
        "sector": {
          "code": "R",
          "label": "Arts, entertainment and recreation"
        },
        "register_status": "Active",
        "nature_of_business": null
      },
      "procedure": "creditors_voluntary_liquidation",
      "procedure_label": "Creditors' 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": 1,
      "last_activity_on": "2026-10-30"
    }
  ],
  "meta": {
    "count": 2,
    "next_cursor": "eyJvIjoyLCJwIjoyfQ",
    "page": 1,
    "limit": 2,
    "total": 100000,
    "total_exact": false,
    "total_pages": null,
    "next_page": 2,
    "prev_page": null
  }
}

Errors it can return

400bad_requestA value is wrong, such as a date in another format. The message says which.401unauthorizedThe key is missing, wrong or no longer valid.422unknown_parameterA parameter this endpoint does not take. The answer lists the ones it does.429rate_limitedToo many calls in one minute. Wait for the seconds in Retry-After.429quota_exceededYour calls for the day or month are used. The answer says when they reset.

Good to know

On Developer, results cover yesterday back 90 days (today appears tomorrow) and paid fields come back as null. Professional and Intel read the full history, back to 1921 where a country goes that far.

Filters on sector, postcode and claims work in the UK and France, where the register gives them.