Home/Documentation/Cases

Insolvency API cases

Notices for one case

Every notice in one case, oldest first.

Every plan

The call

Every notice in one case, oldest first.

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

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

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

FieldTypeWhat it holds

idtextThe notice id, nt_ followed by 8 characters.

case_idtextThe case it belongs to.

countrytextgb or fr.

steptextThe step it records, see /v1/vocabulary.

step_labeltextThe step in plain English.

proceduretextThe procedure it belongs to.

published_ondateThe day it was published.

event_ondate, or nullThe day the notice is about: the order, resolution, appointment or judgment.

companyobjectregister_number and name.

claims_deadlinedate, or nullA deadline for creditors set by this notice (paid plans).

hearingobject, or nullA hearing set by this notice (paid plans).

courttext, or nullThe court (paid plans).

court_case_reftext, or nullThe court's case number (paid plans).

detailsobject, or nullregistered_office, trading_as, previous_name, nature_of_business, legal_form, petitioner, appointed_by, meeting, practitioners (count and roles; never names), where published (paid plans).

An example answer

A real answer from this morning’s data, made by the call Try it opens on, with the first 2 of its 3 rows.

Example answerCopy

{
  "data": [
    {
      "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": {
    "count": 3,
    "next_cursor": null,
    "page": 1,
    "limit": 25,
    "total": 3,
    "total_exact": true,
    "total_pages": 1,
    "next_page": null,
    "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.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.