Insolvency API cases
Pending UK winding-up petitionsUK petitions filed and not yet decided: the earliest warning a company is in trouble.
Professional and IntelMCP tool: pending_petitions
The call
UK winding-up petitions filed and not yet decided, newest first.
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
filed_fromdateOptionalPetitions filed on or after.hearing_fromdateOptionalNext hearing on or after, where published.hearing_todateOptionalNext hearing on or before, where published.qtextOptionalPart of the company name, 3 characters or more.limitnumberOptionalResults a page: 25 if left out, up to 100 on paid plans and 25 on Developer.pagenumberOptionalThe page, from 1.cursortextOptionalThe next_cursor from the page before.What comes back
A list in data, each item with these fields, the same in every country. Paging and counts are in meta; see Pagination.
FieldTypeWhat it holds
idtextThe case id, cs_ followed by 8 characters.countrytextOne of gb, fr, at, cz, ee, fi, hr, ie, lv, no, pt, ro, sk, es, se, pl, us, lt, de, ch, ua, si, kr.companyobjectThe company in the case: register_number, name, town, postcode, sic, sector, register_status, nature_of_business.procedure_labeltextThe procedure in plain English.statustextpetition, open, closing, closed or dismissed (open or closed outside the UK and France).status_labeltextThe status in plain English.petition_ondate, or nullWhen a winding-up petition was presented.opened_ondate, or nullWhen the proceedings opened; where opened_precision is window, the day by which they had opened.opened_afterdate, or nullWhere opened_precision is window: the day before which they had not opened.opened_precisiontextday, or window where a country's records date a start only to a month-long window.closed_ondate, or nullWhen the proceedings closed or a petition was dismissed.closed_bytext, or nullWhat closed it: notice, conversion (a French reorganisation or safeguard converted into liquidation) or register (the register shows the company dissolved or ceased).claims_deadlinedate, or nullThe last day creditors can send their claims (UK and France, paid plans).next_hearingobject, or nullA pending petition's next hearing: date, local_time, timezone, where published (paid plans).last_hearingobject, or nullThe latest hearing any of the case's notices set, past or still ahead, in the same shape (paid plans).courttext, or nullThe court (paid plans).court_case_reftext, or nullThe court's case number, where the country publishes one (paid plans).first_notice_ondate, or nullThe first notice held for the case (UK and France).last_notice_ondate, or nullThe latest notice held for the case (UK and France).notice_countnumberNotices held for the case.last_activity_ondateThe case's latest step: what lists are ordered by.An example answer
A real answer from this morning’s data, made by the call Try it opens on.
Example answerCopy
{
"data": [
{
"id": "cs_kxzra32b",
"country": "gb",
"company": {
"register_number": "SC649899",
"name": "THE MILL FORFAR LTD",
"town": "FORFAR",
"postcode": "DD8 1XF",
"sic": "56101",
"sector": {
"code": "I",
"label": "Accommodation and food services"
},
"register_status": "Active",
"nature_of_business": null
},
"procedure": "compulsory_liquidation",
"procedure_label": "Compulsory liquidation (winding up by the court)",
"status": "petition",
"status_label": "A petition is pending",
"petition_on": "2026-10-30",
"opened_on": null,
"opened_after": null,
"opened_precision": "day",
"closed_on": null,
"closed_by": null,
"claims_deadline": null,
"next_hearing": null,
"last_hearing": null,
"court": null,
"court_case_ref": null,
"first_notice_on": "2026-10-30",
"last_notice_on": "2026-10-30",
"notice_count": 1,
"last_activity_on": "2026-10-30"
},
{
"id": "cs_7xwxv28b",
"country": "gb",
"company": {
"register_number": "SC621130",
"name": "ALI & MAC PROPERTIES LTD",
"town": "ELGIN",
"postcode": "IV30 1EE",
"sic": "68100",
"sector": {
"code": "L",
"label": "Real estate activities"
},
"register_status": "Active",
"nature_of_business": null
},
"procedure": "compulsory_liquidation",
"procedure_label": "Compulsory liquidation (winding up by the court)",
"status": "petition",
"status_label": "A petition is pending",
"petition_on": "2026-10-30",
"opened_on": null,
"opened_after": null,
"opened_precision": "day",
"closed_on": null,
"closed_by": null,
"claims_deadline": null,
"next_hearing": null,
"last_hearing": null,
"court": null,
"court_case_ref": null,
"first_notice_on": "2026-10-30",
"last_notice_on": "2026-10-30",
"notice_count": 1,
"last_activity_on": "2026-10-30"
}
],
"meta": {
"count": 2,
"next_cursor": "eyJvIjoyLCJwIjoyfQ",
"page": 1,
"limit": 2,
"total": 16575,
"total_exact": true,
"total_pages": 8288,
"next_page": 2,
"prev_page": null
}
}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
A petition is not a decision: many are paid off or dismissed. When one is decided, the case moves on in Find cases.