Insolvency API statistics
Who started the casesThe directors, the tax authority, another creditor, a lender or the court: who started the cases, by month, region or sector.
The call
Who started the cases (directors, the tax authority, another creditor, a lender, the court), by month, region or sector.
Try it
Kept in this browser and filled in on every documentation page.
Calls the API from this browser with your key.
Parameters
NameTypeNeededWhat it does
countrylistRequiredgb, fr or both.gbfrbytextOptionalSplit by month, region or sector (month if left out).monthregionsectormonthsnumberOptionalHow many months back, 1 to 60 (12 if left out).frommonthOptionalFrom this month, YYYY-MM (instead of months).tomonthOptionalTo this month, YYYY-MM.regiontextOptionalOne UK postcode area (LS) or French department (75).sectortextOptionalOne sector section, A to U.ABCDEFGHIJKLMNOPQRSTUdriverlistOptionalOnly these drivers, see /v1/vocabulary.directors_resolutiontax_authority_petitionpublic_interest_petitioncreditor_petitionpetitioner_not_givenadministration_by_directorsadministration_by_lenderadministration_by_courtadministration_otherreceiver_by_lenderdirectors_moratoriumsolvent_wind_upearly_protectioncourt_rescueliquidationotherWhat comes back
A list in data, each item with these fields. Paging and counts are in meta; see Pagination.
FieldTypeWhat it holds
countrytextgb or fr.monthtextWith by=month: the month the cases opened, YYYY-MM.regiontextWith by=region: UK postcode area or French department.sectortextWith by=sector: the section, A to U.driver_labeltextThe same in plain English.casesnumberCases opened in the span with this driver.sharenumberIts share of the country and bucket, 0 to 1.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 18 rows.
Example answerCopy
{
"data": [
{
"country": "gb",
"month": "2026-10",
"driver": "directors_resolution",
"driver_label": "The directors and shareholders decided to wind up (creditors' voluntary liquidation)",
"cases": 1808,
"share": 0.556
},
{
"country": "gb",
"month": "2026-10",
"driver": "solvent_wind_up",
"driver_label": "Solvent winding up by the members (members' voluntary liquidation)",
"cases": 969,
"share": 0.298
}
],
"meta": {
"count": 18,
"next_cursor": null,
"page": 1,
"limit": 25,
"total": 18,
"total_exact": true,
"total_pages": 1,
"next_page": null,
"prev_page": null,
"by": "month",
"months": {
"from": "2026-08",
"to": "2026-10"
},
"drivers": "Who started each case, from its procedure and the party its notices name. Not why it failed: no source records that.",
"region_is": "UK postcode area or French department",
"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.
Good to know
In the UK a winding-up petition notice rarely names who presented it, so most court cases there show as
petitioner_not_given, and administrations without the appointer as administration_other. Only who started a case is counted; the reasons a company failed are not published, so they are not given.