Home/Documentation/Reference

Insolvency API reference

Coverage

Every country held: how many cases, how far back, and when it was last read.

Every planMCP tool: coverage

The call

Every country held: how many cases, how far back, and when it was last read.

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

Try it

Your keyGet a free key

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

country

Calls the API from this browser with your key.

curl PHP Python JavaScriptCopy

Code, built from the form

The answer

Parameters

NameTypeNeededWhat it does

countrylistOptionalOnly these countries.gbfratczeefihrielvnoptroskesseplusltdechuasikrbedk

What comes back

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

FieldTypeWhat it holds

countrytextThe country.

nametextThe country in English.

held_astextcases, or official_counts where only national monthly counts are held.

casesnumber, or nullCases held.

active_casesnumber, or nullPending petitions, open and closing cases.

earliest_ondateThe earliest case or count held.

latest_ondateThe latest held.

noticesnumberNotices held (UK and France).

court_case_reftrue or falseWhether court case numbers are given.

claims_deadlinestrue or falseWhether claims deadlines are given.

opened_precisiontextday, window or month.

sampletrue or false, or nullTrue where the cases held are a sample (the US court feeds), not every case; the monthly counts carry that country.

last_readtime, UTC, or nullWhen the country was last read.

An example answer

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

Example answerCopy

{
  "data": [
    {
      "country": "gb",
      "name": "United Kingdom",
      "held_as": "cases",
      "cases": 717978,
      "active_cases": 237084,
      "earliest_on": "1921-06-23",
      "latest_on": "2026-10-30",
      "notices": 1678029,
      "court_case_ref": true,
      "claims_deadlines": true,
      "opened_precision": "day",
      "sample": false,
      "last_read": "2026-10-30T18:05:20Z"
    },
    {
      "country": "fr",
      "name": "France",
      "held_as": "cases",
      "cases": 1254378,
      "active_cases": 258080,
      "earliest_on": "1985-12-27",
      "latest_on": "2026-10-30",
      "notices": 2495931,
      "court_case_ref": false,
      "claims_deadlines": true,
      "opened_precision": "day",
      "sample": false,
      "last_read": "2026-10-30T06:53:35Z"
    }
  ],
  "meta": {
    "count": 2,
    "counted_at": "2026-10-31T00:51:09Z"
  }
}

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

The same list as the Coverage page, counted afresh every hour.