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/Reference

Insolvency API reference

Data gaps, every country

Every place in the world: what is held, what is missing, and what we are doing about it. Free, no key needed.

Every planMCP tool: data_gaps

The call

Every place in the world: what is held, what is missing and what we are doing about it. Free, no key needed, never counted.

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

Try it

Get a free key
Kept in this browser and filled in on every documentation page.
Calls the API from this browser with your key.
curlPHPPythonJavaScriptCopy
Code, built from the form
The answer
Parameters
NameTypeNeededWhat it does
kindtextOptionalOnly places of this kind.completemissingbehinduncheckednomonthnone
What comes back
A list in data, each item with these fields. Paging and counts are in meta; see Pagination.
FieldTypeWhat it holds
countrytextISO 3166-1, two letters.
nametextThe place in English.
kindtextcomplete, missing, behind, unchecked (monthly, not yet checked against an official count), nomonth (quarterly or yearly only) or none.
frequencytext, or nullM, Q or Y: how the headline figure is held.
firsttext, or nullThe first period held.
lasttext, or nullThe newest period held.
heldnumberPeriods held.
missingnumberPeriods missing between first and last.
detailtext, or nullWhat is not complete, in words.
actiontext, or nullWhat we are doing about it.
checked_attime, UTC, or nullWhen it was last checked.
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": [
    {
      "country": "bl",
      "name": "Saint Barthelemy",
      "kind": "missing",
      "frequency": "M",
      "first": "2024-11",
      "last": "2026-09",
      "held": 18,
      "missing": 5,
      "detail": "5 months missing: Mar 2025, May 2025, Feb 2026 and 2 more",
      "action": "Looking for the missing months at the publisher and in a second official source.",
      "checked_at": "2026-10-30T03:21:31Z"
    },
    {
      "country": "gp",
      "name": "Guadeloupe",
      "kind": "missing",
      "frequency": "M",
      "first": "2020-06",
      "last": "2026-09",
      "held": 75,
      "missing": 1,
      "detail": "1 month missing: Aug 2021",
      "action": "Looking for the missing months at the publisher and in a second official source.",
      "checked_at": "2026-10-30T03:21:31Z"
    }
  ],
  "meta": {
    "places": 243,
    "complete": 30,
    "missing": 3,
    "behind": 1,
    "unchecked": 5,
    "nomonth": 5,
    "none": 199,
    "checked_at": "2026-10-30T03:21:31Z",
    "page": "https://insolvencyapi.com/data-gaps"
  }
}
Errors it can return
400bad_requestA value is wrong, such as a date in another format. The message says which.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.
Good to know
No key needed and never counted: a call without a key works, at up to 60 a minute from one address. Every place is in the list, including those we hold nothing for yet.
The same list as the Data gaps page and the open issues on the Status page, checked every night.