Home/Documentation/Cases

Insolvency API cases

One case, with its notices

One case with every notice in it, oldest first, where the country publishes notices.

Every planMCP tool: get_case

The call

One case, with every notice in it in date order where the country publishes notices.

GEThttps://api.insolvencyapi.com/v1/cases/{case_id}

Try it

Your keyGet a free key

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

case_id required

Calls the API from this browser with your key.

curl PHP Python JavaScriptCopy

Code, built from the form

The answer

Parameters

NameTypeNeededWhat it does

case_idtextRequiredThe case id, such as cs_7hq2lwx4, in the address.

What comes back

One record in data, with these fields. 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.

noticeslistEvery notice in the case, oldest first; empty where the country publishes no notices we hold.

An example answer

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

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",
    "notices": [
      {
        "id": "nt_cegh63t0",
        "case_id": "cs_k54b7nzt",
        "country": "gb",
        "step": "notice_to_creditors",
        "step_label": "Notice to creditors to prove debts",
        "procedure": "members_voluntary_liquidation",
        "published_on": "2026-10-30",
        "event_on": null,
        "company": {
          "register_number": "04542915",
          "name": "KMJ VENTILATION LIMITED"
        },
        "claims_deadline": null,
        "hearing": null,
        "court": null,
        "court_case_ref": null,
        "details": []
      },
      {
        "id": "nt_275e60z4",
        "case_id": "cs_k54b7nzt",
        "country": "gb",
        "step": "liquidator_appointed",
        "step_label": "Liquidator appointed",
        "procedure": "members_voluntary_liquidation",
        "published_on": "2026-10-30",
        "event_on": null,
        "company": {
          "register_number": "04542915",
          "name": "KMJ VENTILATION LIMITED"
        },
        "claims_deadline": null,
        "hearing": null,
        "court": null,
        "court_case_ref": null,
        "details": []
      }
    ]
  },
  "meta": {}
}

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.404not_foundNo record with that id. An empty list is never a 404.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

Notices are held for the UK and France. In the other countries the case comes from the register and court records, with its dates, and notices is empty.