54 of 57 sources live 23 countries, Europe, North America and South Korea Last read Romania, 11 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 for one country

One country in full: every month missing, not published or withheld, and its open issue. Free, no key needed.

Every plan

The call

One country in full: every month missing, not published or withheld, and its open issue. Free, no key needed, never counted.

GEThttps://api.insolvencyapi.com/v1/gaps/{country}

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
countrytextRequiredTwo letters, in the address.
What comes back
One record in data, with these fields. Paging and counts are in meta; see Pagination.
FieldTypeWhat it holds
countrytextISO 3166-1, two letters.
nametextThe place in English.
serieslistThe headline series: measure, frequency, held_as (counted_from_cases, official_count or official_index), first, last, held, and the lists missing, not_published and withheld.
issueobject, or nullkind, detail, action and checked_at; null when the country is complete and current.
An example answer
A real answer from this morning’s data, made by the call Try it opens on.
Example answerCopy
{
  "data": {
    "country": "bl",
    "name": "Saint Barthelemy",
    "series": [
      {
        "measure": "corporate_insolvencies",
        "frequency": "M",
        "held_as": "counted_from_cases",
        "first": "2024-11",
        "last": "2026-09",
        "held": 18,
        "missing": [
          "2025-03",
          "2025-05",
          "2026-02",
          "2026-07",
          "2026-08"
        ],
        "not_published": [],
        "withheld": [],
        "checked_at": "2026-10-30T03:21:31Z"
      }
    ],
    "issue": {
      "kind": "missing",
      "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"
    }
  },
  "meta": {
    "page": "https://insolvencyapi.com/data-gaps/bl"
  }
}
Errors it can return
400bad_requestA value is wrong, such as a date in another format. The message says which.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.
Good to know
No key needed and never counted.
A month is missing when the publisher released it and we do not hold it, not_published when the publisher never released it, and withheld when we hold it but do not serve it.