Home/Documentation/Statistics

Insolvency API statistics

How cases end

For the cases opened each year: closed, converted, ended on the register, dismissed or still open.

Intel

The call

How the cases opened each year have ended so far.

GEThttps://api.insolvencyapi.com/v1/stats/outcomes

Try it

Your keyGet a free key

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

country

procedure

from

Calls the API from this browser with your key.

curl PHP Python JavaScriptCopy

Code, built from the form

The answer

Parameters

NameTypeNeededWhat it does

countrylistOptionalOne or more countries, comma separated.gbfratczeefihrielvnoptroskesseplusltdechuasikr

procedurelistOptionalOnly these procedures.compulsory_liquidationcreditors_voluntary_liquidationmembers_voluntary_liquidationadministrationadministrative_receivershipreceivershipmoratoriumjudicial_liquidationjudicial_reorganisationsafeguardconciliationotherbankruptcyinsolvencyliquidationliquidation_unspecifiedrestructuringforced_dissolutionexternal_administration

fromyearOptionalOpened in or after this year, YYYY.

toyearOptionalOpened in or before this year, YYYY.

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.

proceduretextThe procedure.

opened_innumberThe year the cases opened.

casesnumberCases opened that year.

still_opennumberShare not ended yet, 0 to 1.

closednumberShare closed.

convertednumberShare converted into another procedure (France).

ended_on_registernumberShare with no closing notice held, the company dissolved or ceased on the register.

dismissednumberShare set aside or dismissed.

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 29 rows.

Example answerCopy

{
  "data": [
    {
      "country": "fr",
      "procedure": "judicial_liquidation",
      "opened_in": 1988,
      "cases": 1,
      "still_open": 0,
      "closed": 1,
      "converted": 0,
      "ended_on_register": 0,
      "dismissed": 0
    },
    {
      "country": "fr",
      "procedure": "judicial_liquidation",
      "opened_in": 1994,
      "cases": 1,
      "still_open": 1,
      "closed": 0,
      "converted": 0,
      "ended_on_register": 0,
      "dismissed": 0
    }
  ],
  "meta": {
    "count": 29,
    "shares": "Each outcome as a share of the cases opened that year, 0 to 1. Converted, ended on the register and dismissed are known for the UK and France.",
    "built_at": "2026-10-31T00:50:40Z",
    "note": "Counted from the cases held, rebuilt every day. The latest month fills in as late publications arrive."
  }
}

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.403upgrade_requiredYour plan does not include this. The answer names the plan that does.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.