{ "openapi": "3.0.3", "info": { "title": "InsolvencyAPI", "version": "1", "description": "Company insolvency cases in 23 countries, with notices for the United Kingdom and France, in one vocabulary. Send your key as `Authorization: Bearer `. A free Developer key is at https://insolvencyapi.com/pricing.\n\n**Countries with cases:** United Kingdom (`gb`), France (`fr`), Austria (`at`), Czechia (`cz`), Estonia (`ee`), Finland (`fi`), Croatia (`hr`), Ireland (`ie`), Latvia (`lv`), Norway (`no`), Portugal (`pt`), Romania (`ro`), Slovakia (`sk`), Spain (`es`), Sweden (`se`), Poland (`pl`), United States (`us`), Lithuania (`lt`), Germany (`de`), Switzerland (`ch`), Ukraine (`ua`), Slovenia (`si`), South Korea (`kr`).\n\n**Limits by plan:**\n\n| Plan | Price a month | A minute | Quota | Results a page | History |\n|---|---|---|---|---|---|\n| Developer | $0 | 30 | 100 a day | 25 | the last 90 days |\n| Professional | $149 | 120 | 50,000 a month | 100 | full |\n| Intel | $249 | 300 | 100,000 a month | 100 | full |\n\nEvery answer carries `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset`; over a limit the answer is 429 with `Retry-After`. The free key reads up to yesterday; anything published today appears on it tomorrow. Errors: https://insolvencyapi.com/documentation/errors", "contact": { "email": "support@developerdata.net", "url": "https://insolvencyapi.com/support" }, "termsOfService": "https://insolvencyapi.com/terms" }, "externalDocs": { "description": "Guides, every endpoint with Try it, and the full manual", "url": "https://insolvencyapi.com/documentation" }, "x-countries": [ { "code": "gb", "name": "United Kingdom" }, { "code": "fr", "name": "France" }, { "code": "at", "name": "Austria" }, { "code": "cz", "name": "Czechia" }, { "code": "ee", "name": "Estonia" }, { "code": "fi", "name": "Finland" }, { "code": "hr", "name": "Croatia" }, { "code": "ie", "name": "Ireland" }, { "code": "lv", "name": "Latvia" }, { "code": "no", "name": "Norway" }, { "code": "pt", "name": "Portugal" }, { "code": "ro", "name": "Romania" }, { "code": "sk", "name": "Slovakia" }, { "code": "es", "name": "Spain" }, { "code": "se", "name": "Sweden" }, { "code": "pl", "name": "Poland" }, { "code": "us", "name": "United States" }, { "code": "lt", "name": "Lithuania" }, { "code": "de", "name": "Germany" }, { "code": "ch", "name": "Switzerland" }, { "code": "ua", "name": "Ukraine" }, { "code": "si", "name": "Slovenia" }, { "code": "kr", "name": "South Korea" } ], "x-rate-limits": [ { "plan": "Developer", "price_usd_month": 0, "per_minute": 30, "per_day": 100, "per_month": null, "per_page_max": 25, "history_days": 90 }, { "plan": "Professional", "price_usd_month": 149, "per_minute": 120, "per_day": null, "per_month": 50000, "per_page_max": 100, "history_days": null }, { "plan": "Intel", "price_usd_month": 249, "per_minute": 300, "per_day": null, "per_month": 100000, "per_page_max": 100, "history_days": null } ], "servers": [ { "url": "https://api.insolvencyapi.com" } ], "security": [ { "bearer": [] } ], "components": { "securitySchemes": { "bearer": { "type": "http", "scheme": "bearer" } }, "schemas": { "Case": { "type": "object", "properties": { "id": { "description": "The case id, cs_ followed by 8 characters", "nullable": false, "type": "string" }, "country": { "description": "One of gb, fr, at, cz, ee, fi, hr, ie, lv, no, pt, ro, sk, es, se, pl, us, lt, de, ch, ua, si, kr", "nullable": false, "type": "string" }, "company": { "description": "The company in the case: register_number, name, town, postcode, sic, sector, register_status, nature_of_business", "nullable": false, "type": "object" }, "procedure": { "description": "The procedure, see /v1/vocabulary", "nullable": false, "type": "string" }, "procedure_label": { "description": "The procedure in plain English", "nullable": false, "type": "string" }, "status": { "description": "petition, open, closing, closed or dismissed (open or closed outside the UK and France)", "nullable": false, "type": "string" }, "status_label": { "description": "The status in plain English", "nullable": false, "type": "string" }, "petition_on": { "description": "When a winding-up petition was presented", "nullable": true, "type": "string", "format": "date" }, "opened_on": { "description": "When the proceedings opened; where opened_precision is window, the day by which they had opened", "nullable": true, "type": "string", "format": "date" }, "opened_after": { "description": "Where opened_precision is window: the day before which they had not opened", "nullable": true, "type": "string", "format": "date" }, "opened_precision": { "description": "day, or window where a country's records date a start only to a month-long window", "nullable": false, "type": "string" }, "closed_on": { "description": "When the proceedings closed or a petition was dismissed", "nullable": true, "type": "string", "format": "date" }, "closed_by": { "description": "What closed it: notice, conversion (a French reorganisation or safeguard converted into liquidation) or register (the register shows the company dissolved or ceased)", "nullable": true, "type": "string" }, "claims_deadline": { "description": "The last day creditors can send their claims (UK and France, paid plans)", "nullable": true, "type": "string", "format": "date" }, "next_hearing": { "description": "A pending petition's next hearing: date, local_time, timezone, where published (paid plans)", "nullable": true, "type": "object" }, "last_hearing": { "description": "The latest hearing any of the case's notices set, past or still ahead, in the same shape (paid plans)", "nullable": true, "type": "object" }, "court": { "description": "The court (paid plans)", "nullable": true, "type": "string" }, "court_case_ref": { "description": "The court's case number, where the country publishes one (paid plans)", "nullable": true, "type": "string" }, "first_notice_on": { "description": "The first notice held for the case (UK and France)", "nullable": true, "type": "string", "format": "date" }, "last_notice_on": { "description": "The latest notice held for the case (UK and France)", "nullable": true, "type": "string", "format": "date" }, "notice_count": { "description": "Notices held for the case", "nullable": false, "type": "integer" }, "last_activity_on": { "description": "The case's latest step: what lists are ordered by", "nullable": false, "type": "string", "format": "date" } } }, "CaseCompany": { "type": "object", "properties": { "register_number": { "description": "The company's number in its country's register (UK company number, French SIREN and the like); null for a US court case found by the debtor's name", "nullable": true, "type": "string" }, "name": { "description": "The company's name as published", "nullable": false, "type": "string" }, "town": { "description": "Registered office town (UK and France, paid plans)", "nullable": true, "type": "string" }, "postcode": { "description": "Registered office postcode (UK and France, paid plans)", "nullable": true, "type": "string" }, "sic": { "description": "Main activity code: UK SIC 2007, or French NAF rev. 2 (paid plans)", "nullable": true, "type": "string" }, "sector": { "description": "The activity's section, the same 21 for both countries: code (A to U) and label (UK and France, paid plans)", "nullable": true, "type": "object" }, "register_status": { "description": "Status on the national company register, as the register words it (paid plans)", "nullable": true, "type": "string" }, "nature_of_business": { "description": "What the company did, as published (paid plans)", "nullable": true, "type": "string" } } }, "CaseWithNotices": { "type": "object", "properties": { "id": { "description": "The case id, cs_ followed by 8 characters", "nullable": false, "type": "string" }, "country": { "description": "One of gb, fr, at, cz, ee, fi, hr, ie, lv, no, pt, ro, sk, es, se, pl, us, lt, de, ch, ua, si, kr", "nullable": false, "type": "string" }, "company": { "description": "The company in the case: register_number, name, town, postcode, sic, sector, register_status, nature_of_business", "nullable": false, "type": "object" }, "procedure": { "description": "The procedure, see /v1/vocabulary", "nullable": false, "type": "string" }, "procedure_label": { "description": "The procedure in plain English", "nullable": false, "type": "string" }, "status": { "description": "petition, open, closing, closed or dismissed (open or closed outside the UK and France)", "nullable": false, "type": "string" }, "status_label": { "description": "The status in plain English", "nullable": false, "type": "string" }, "petition_on": { "description": "When a winding-up petition was presented", "nullable": true, "type": "string", "format": "date" }, "opened_on": { "description": "When the proceedings opened; where opened_precision is window, the day by which they had opened", "nullable": true, "type": "string", "format": "date" }, "opened_after": { "description": "Where opened_precision is window: the day before which they had not opened", "nullable": true, "type": "string", "format": "date" }, "opened_precision": { "description": "day, or window where a country's records date a start only to a month-long window", "nullable": false, "type": "string" }, "closed_on": { "description": "When the proceedings closed or a petition was dismissed", "nullable": true, "type": "string", "format": "date" }, "closed_by": { "description": "What closed it: notice, conversion (a French reorganisation or safeguard converted into liquidation) or register (the register shows the company dissolved or ceased)", "nullable": true, "type": "string" }, "claims_deadline": { "description": "The last day creditors can send their claims (UK and France, paid plans)", "nullable": true, "type": "string", "format": "date" }, "next_hearing": { "description": "A pending petition's next hearing: date, local_time, timezone, where published (paid plans)", "nullable": true, "type": "object" }, "last_hearing": { "description": "The latest hearing any of the case's notices set, past or still ahead, in the same shape (paid plans)", "nullable": true, "type": "object" }, "court": { "description": "The court (paid plans)", "nullable": true, "type": "string" }, "court_case_ref": { "description": "The court's case number, where the country publishes one (paid plans)", "nullable": true, "type": "string" }, "first_notice_on": { "description": "The first notice held for the case (UK and France)", "nullable": true, "type": "string", "format": "date" }, "last_notice_on": { "description": "The latest notice held for the case (UK and France)", "nullable": true, "type": "string", "format": "date" }, "notice_count": { "description": "Notices held for the case", "nullable": false, "type": "integer" }, "last_activity_on": { "description": "The case's latest step: what lists are ordered by", "nullable": false, "type": "string", "format": "date" }, "notices": { "description": "Every notice in the case, oldest first; empty where the country publishes no notices we hold", "nullable": false, "type": "array", "items": { "$ref": "#/components/schemas/Notice" } } } }, "Notice": { "type": "object", "properties": { "id": { "description": "The notice id, nt_ followed by 8 characters", "nullable": false, "type": "string" }, "case_id": { "description": "The case it belongs to", "nullable": false, "type": "string" }, "country": { "description": "gb or fr", "nullable": false, "type": "string" }, "step": { "description": "The step it records, see /v1/vocabulary", "nullable": false, "type": "string" }, "step_label": { "description": "The step in plain English", "nullable": false, "type": "string" }, "procedure": { "description": "The procedure it belongs to", "nullable": false, "type": "string" }, "published_on": { "description": "The day it was published", "nullable": false, "type": "string", "format": "date" }, "event_on": { "description": "The day the notice is about: the order, resolution, appointment or judgment", "nullable": true, "type": "string", "format": "date" }, "company": { "description": "register_number and name", "nullable": false, "type": "object" }, "claims_deadline": { "description": "A deadline for creditors set by this notice (paid plans)", "nullable": true, "type": "string", "format": "date" }, "hearing": { "description": "A hearing set by this notice (paid plans)", "nullable": true, "type": "object" }, "court": { "description": "The court (paid plans)", "nullable": true, "type": "string" }, "court_case_ref": { "description": "The court's case number (paid plans)", "nullable": true, "type": "string" }, "details": { "description": "registered_office, trading_as, previous_name, nature_of_business, legal_form, petitioner, appointed_by, meeting, practitioners (count and roles; never names), where published (paid plans)", "nullable": true, "type": "object" } } }, "Company": { "type": "object", "properties": { "country": { "description": "One of gb, fr, at, cz, ee, fi, hr, ie, lv, no, pt, ro, sk, es, se, pl, us, lt, de, ch, ua, si, kr", "nullable": false, "type": "string" }, "register_number": { "description": "The register number", "nullable": false, "type": "string" }, "name": { "description": "The company's name", "nullable": false, "type": "string" }, "register": { "description": "UK register details: status, category, incorporated_on, dissolved_on, sic, sic_label, town, postcode, filings (accounts and confirmation statement made-up and due dates, overdue flags, days late), as_of", "nullable": true, "type": "object" }, "accounts": { "description": "UK only, paid plans: balance-sheet figures from the accounts filed online, newest three periods (period_end, employees, turnover, profit_loss, assets, cash, debtors, creditors, bank_borrowings, tax_payable, net_current_assets, net_assets, in GBP), and warning_signs on the newest: net_liabilities, current_liabilities_exceed_assets, net_assets_fell. Null when none are held", "nullable": true, "type": "object" }, "in_insolvency": { "description": "True when any case is a pending petition, open or closing", "nullable": false, "type": "boolean" }, "open_case_count": { "description": "How many of its cases are active", "nullable": false, "type": "integer" }, "cases": { "description": "Every case the company has, newest first", "nullable": false, "type": "array", "items": { "$ref": "#/components/schemas/Case" } }, "checked_at": { "description": "When the answer was worked out", "nullable": false, "type": "string" } } }, "CompanySummary": { "type": "object", "properties": { "country": { "description": "The country", "nullable": false, "type": "string" }, "register_number": { "description": "The register number", "nullable": true, "type": "string" }, "name": { "description": "The company's name", "nullable": false, "type": "string" }, "in_insolvency": { "description": "True when any case is active", "nullable": false, "type": "boolean" }, "case_count": { "description": "Cases held", "nullable": false, "type": "integer" }, "last_activity_on": { "description": "The latest step in any of its cases", "nullable": false, "type": "string", "format": "date" } } }, "CheckResult": { "type": "object", "properties": { "index": { "description": "The company's position in your list", "nullable": false, "type": "integer" }, "matched": { "description": "True when a company was found", "nullable": false, "type": "boolean" }, "match": { "description": "register_number, name_and_postcode, name, ambiguous or none", "nullable": false, "type": "string" }, "candidates": { "description": "Up to 3 possible companies when the match is ambiguous", "nullable": false, "type": "array", "items": { "type": "object" } }, "countries_checked": { "description": "For a name with no country: how many countries were checked", "nullable": false, "type": "integer" }, "company": { "description": "country, register_number and name", "nullable": true, "type": "object" }, "in_insolvency": { "description": "True when any case is active", "nullable": false, "type": "boolean" }, "cases": { "description": "The company's cases", "nullable": false, "type": "array", "items": { "$ref": "#/components/schemas/Case" } }, "error": { "description": "Why this one item could not be checked, when it could not", "nullable": false, "type": "string" } } }, "Usage": { "type": "object", "properties": { "key": { "description": "prefix: your key's first characters, never the key", "nullable": false, "type": "object" }, "plan": { "description": "Your plan", "nullable": false, "type": "string" }, "plan_name": { "description": "Its name", "nullable": false, "type": "string" }, "calls": { "description": "today and this_month, counted in UTC", "nullable": false, "type": "object" }, "limits": { "description": "per_minute, per_day, per_month, limit_max", "nullable": false, "type": "object" }, "resets": { "description": "When the day and month reset", "nullable": false, "type": "object" }, "reads_from": { "description": "The earliest date your plan reads, or null for everything", "nullable": true, "type": "string", "format": "date" }, "paid_fields": { "description": "Whether paid fields are filled", "nullable": false, "type": "boolean" }, "countries": { "description": "Countries covered", "nullable": false, "type": "array", "items": { "type": "string" } } } }, "Coverage": { "type": "object", "properties": { "country": { "description": "The country", "nullable": false, "type": "string" }, "name": { "description": "The country in English", "nullable": false, "type": "string" }, "held_as": { "description": "cases, or official_counts where only national monthly counts are held", "nullable": false, "type": "string" }, "cases": { "description": "Cases held", "nullable": true, "type": "integer" }, "active_cases": { "description": "Pending petitions, open and closing cases", "nullable": true, "type": "integer" }, "earliest_on": { "description": "The earliest case or count held", "nullable": false, "type": "string", "format": "date" }, "latest_on": { "description": "The latest held", "nullable": false, "type": "string", "format": "date" }, "notices": { "description": "Notices held (UK and France)", "nullable": false, "type": "integer" }, "court_case_ref": { "description": "Whether court case numbers are given", "nullable": false, "type": "boolean" }, "claims_deadlines": { "description": "Whether claims deadlines are given", "nullable": false, "type": "boolean" }, "opened_precision": { "description": "day, window or month", "nullable": false, "type": "string" }, "sample": { "description": "True where the cases held are a sample (the US court feeds), not every case; the monthly counts carry that country", "nullable": true, "type": "boolean" }, "last_read": { "description": "When the country was last read", "nullable": true, "type": "string" } } }, "Gap": { "type": "object", "properties": { "country": { "description": "ISO 3166-1, two letters", "nullable": false, "type": "string" }, "name": { "description": "The place in English", "nullable": false, "type": "string" }, "kind": { "description": "complete, missing, behind, unchecked (monthly, not yet checked against an official count), nomonth (quarterly or yearly only) or none", "nullable": false, "type": "string" }, "frequency": { "description": "M, Q or Y: how the headline figure is held", "nullable": true, "type": "string" }, "first": { "description": "The first period held", "nullable": true, "type": "string" }, "last": { "description": "The newest period held", "nullable": true, "type": "string" }, "held": { "description": "Periods held", "nullable": false, "type": "integer" }, "missing": { "description": "Periods missing between first and last", "nullable": false, "type": "integer" }, "detail": { "description": "What is not complete, in words", "nullable": true, "type": "string" }, "action": { "description": "What we are doing about it", "nullable": true, "type": "string" }, "checked_at": { "description": "When it was last checked", "nullable": true, "type": "string" } } }, "GapCountry": { "type": "object", "properties": { "country": { "description": "ISO 3166-1, two letters", "nullable": false, "type": "string" }, "name": { "description": "The place in English", "nullable": false, "type": "string" }, "series": { "description": "The 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", "nullable": false, "type": "array", "items": { "type": "object" } }, "issue": { "description": "kind, detail, action and checked_at; null when the country is complete and current", "nullable": true, "type": "object" } } }, "OfficialCount": { "type": "object", "properties": { "country": { "description": "The country", "nullable": false, "type": "string" }, "measure": { "description": "corporate_insolvencies, or corporate_insolvencies_index for the index", "nullable": false, "type": "string" }, "frequency": { "description": "M, Q or Y", "nullable": false, "type": "string" }, "period": { "description": "2026-08, 2026-Q2 or 2025", "nullable": false, "type": "string" }, "value": { "description": "The figure as published", "nullable": false, "type": "string" }, "unit": { "description": "companies, or index, 2021 = 100", "nullable": false, "type": "string" } } }, "Vocabulary": { "type": "object", "properties": { "countries": { "description": "code, label, held_as and whether notices are held", "nullable": false, "type": "array", "items": { "type": "object" } }, "procedures": { "description": "code and label", "nullable": false, "type": "array", "items": { "type": "object" } }, "notice_steps": { "description": "code and label", "nullable": false, "type": "array", "items": { "type": "object" } }, "case_statuses": { "description": "code and label", "nullable": false, "type": "array", "items": { "type": "object" } }, "sectors": { "description": "code (A to U) and label: the sections UK SIC 2007 and French NAF rev. 2 share", "nullable": false, "type": "array", "items": { "type": "object" } }, "drivers": { "description": "code and label: who started a case, for /v1/stats/drivers", "nullable": false, "type": "array", "items": { "type": "object" } } } }, "StatMonth": { "type": "object", "properties": { "country": { "description": "The country", "nullable": false, "type": "string" }, "month": { "description": "YYYY-MM", "nullable": false, "type": "string" }, "held_as": { "description": "cases, or official_counts for Belgium and Denmark", "nullable": false, "type": "string" }, "cases": { "description": "Companies entering insolvency that month", "nullable": false, "type": "integer" }, "closed": { "description": "Cases closed that month (countries with cases)", "nullable": true, "type": "integer" }, "unemployment_rate": { "description": "With with=unemployment: the unemployment rate, %", "nullable": true, "type": "string" }, "inflation_rate": { "description": "With with=inflation: inflation over 12 months, %", "nullable": true, "type": "string" }, "interest_rate": { "description": "With with=interest_rate: the central bank rate at the month's end, % (euro area countries)", "nullable": true, "type": "string" } } }, "StatSector": { "type": "object", "properties": { "sector": { "description": "The section, A to U", "nullable": false, "type": "string" }, "label": { "description": "Its name", "nullable": false, "type": "string" }, "cases": { "description": "Proceedings opened in the span", "nullable": false, "type": "integer" }, "closed": { "description": "Proceedings closed in the span", "nullable": false, "type": "integer" }, "companies": { "description": "Companies in the sector on the national register today", "nullable": true, "type": "integer" }, "per_10000_companies": { "description": "Cases for every 10,000 of them", "nullable": true, "type": "string" }, "share_of_cases": { "description": "Its share of all cases, 0 to 1", "nullable": false, "type": "string" } } }, "StatRegion": { "type": "object", "properties": { "region": { "description": "UK postcode area or French department", "nullable": false, "type": "string" }, "cases": { "description": "Proceedings opened in the span", "nullable": false, "type": "integer" }, "closed": { "description": "Proceedings closed in the span", "nullable": false, "type": "integer" }, "share_of_cases": { "description": "Its share of all cases, 0 to 1", "nullable": false, "type": "string" } } }, "StatDriver": { "type": "object", "properties": { "country": { "description": "gb or fr", "nullable": false, "type": "string" }, "month": { "description": "With by=month: the month the cases opened, YYYY-MM", "nullable": false, "type": "string" }, "region": { "description": "With by=region: UK postcode area or French department", "nullable": false, "type": "string" }, "sector": { "description": "With by=sector: the section, A to U", "nullable": false, "type": "string" }, "driver": { "description": "Who started the cases, see /v1/vocabulary", "nullable": false, "type": "string" }, "driver_label": { "description": "The same in plain English", "nullable": false, "type": "string" }, "cases": { "description": "Cases opened in the span with this driver", "nullable": false, "type": "integer" }, "share": { "description": "Its share of the country and bucket, 0 to 1", "nullable": false, "type": "string" } } }, "StatDuration": { "type": "object", "properties": { "country": { "description": "The country", "nullable": false, "type": "string" }, "procedure": { "description": "The procedure", "nullable": false, "type": "string" }, "closed_in": { "description": "The year the cases closed", "nullable": false, "type": "integer" }, "cases": { "description": "Cases counted", "nullable": false, "type": "integer" }, "median_days": { "description": "The middle duration, opening to closing, in days", "nullable": false, "type": "integer" }, "quarter_days": { "description": "A quarter closed within this many days", "nullable": false, "type": "integer" }, "three_quarters_days": { "description": "Three quarters closed within this many days", "nullable": false, "type": "integer" } } }, "StatOutcome": { "type": "object", "properties": { "country": { "description": "The country", "nullable": false, "type": "string" }, "procedure": { "description": "The procedure", "nullable": false, "type": "string" }, "opened_in": { "description": "The year the cases opened", "nullable": false, "type": "integer" }, "cases": { "description": "Cases opened that year", "nullable": false, "type": "integer" }, "still_open": { "description": "Share not ended yet, 0 to 1", "nullable": false, "type": "string" }, "closed": { "description": "Share closed", "nullable": false, "type": "string" }, "converted": { "description": "Share converted into another procedure (France)", "nullable": false, "type": "string" }, "ended_on_register": { "description": "Share with no closing notice held, the company dissolved or ceased on the register", "nullable": false, "type": "string" }, "dismissed": { "description": "Share set aside or dismissed", "nullable": false, "type": "string" } } }, "StatTrend": { "type": "object", "properties": { "country": { "description": "The country", "nullable": false, "type": "string" }, "sector": { "description": "The section, when split by sector", "nullable": true, "type": "string" }, "sector_label": { "description": "Its name", "nullable": true, "type": "string" }, "last_3_months": { "description": "Cases in the last three complete months", "nullable": false, "type": "integer" }, "usual": { "description": "The usual figure for those months in the years before", "nullable": false, "type": "integer" }, "years_compared": { "description": "How many earlier years were held to compare with, up to 3", "nullable": false, "type": "integer" }, "change": { "description": "How far above or below usual: 0.345 is 34.5% above", "nullable": false, "type": "string" }, "direction": { "description": "rising, steady or falling (10% either way)", "nullable": false, "type": "string" } } }, "StatCompare": { "type": "object", "properties": { "country": { "description": "The country", "nullable": false, "type": "string" }, "name": { "description": "The country in English", "nullable": false, "type": "string" }, "cases": { "description": "Cases opened in the span", "nullable": false, "type": "integer" }, "cases_per_month": { "description": "Cases a month on average", "nullable": false, "type": "string" }, "companies": { "description": "Companies on the register (UK and France)", "nullable": true, "type": "integer" }, "per_10000_companies": { "description": "Cases for every 10,000 companies, where the register is held", "nullable": true, "type": "string" } } }, "Error": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "bad_request", "unauthorized", "upgrade_required", "not_found", "unknown_parameter", "rate_limited", "quota_exceeded", "server_error" ] }, "message": { "type": "string" }, "plan": { "type": "string" }, "docs": { "type": "string" } } } } } } }, "paths": { "/v1/cases": { "get": { "summary": "Every case held in 18 countries, newest activity first, filtered any way you like", "operationId": "cases", "description": "Plans: Developer, Professional, Intel. Docs: https://insolvencyapi.com/documentation/cases", "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more countries, comma separated. Any of: gb, fr, at, cz, ee, fi, hr, ie, lv, no, pt, ro, sk, es, se, pl, us, lt, de, ch, ua, si, kr", "schema": { "type": "string" }, "example": "gb,fr" }, { "name": "procedure", "in": "query", "required": false, "description": "One or more procedures, see /v1/vocabulary. Any of: compulsory_liquidation, creditors_voluntary_liquidation, members_voluntary_liquidation, administration, administrative_receivership, receivership, moratorium, judicial_liquidation, judicial_reorganisation, safeguard, conciliation, other, bankruptcy, insolvency, liquidation, liquidation_unspecified, restructuring, forced_dissolution, external_administration", "schema": { "type": "string" }, "example": "compulsory_liquidation" }, { "name": "status", "in": "query", "required": false, "description": "petition, open, closing, closed or dismissed. Any of: petition, open, closing, closed, dismissed", "schema": { "type": "string" }, "example": "open" }, { "name": "opened_from", "in": "query", "required": false, "description": "Proceedings opened on or after", "schema": { "type": "string", "format": "date" }, "example": "2026-10-01" }, { "name": "opened_to", "in": "query", "required": false, "description": "Proceedings opened on or before", "schema": { "type": "string", "format": "date" }, "example": "2026-10-31" }, { "name": "updated_since", "in": "query", "required": false, "description": "Only cases with something new on or after this day", "schema": { "type": "string", "format": "date" }, "example": "2026-10-13" }, { "name": "sector", "in": "query", "required": false, "description": "One or more sector sections, A to U, see /v1/vocabulary (UK and France). Any of: A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U", "schema": { "type": "string" }, "example": "F" }, { "name": "claims_open", "in": "query", "required": false, "description": "true for cases still taking creditors' claims (UK and France)", "schema": { "type": "boolean", "enum": [ true, false ] }, "example": "true" }, { "name": "register_number", "in": "query", "required": false, "description": "One company, by its number in its country's register (needs one country)", "schema": { "type": "string" }, "example": "" }, { "name": "postcode", "in": "query", "required": false, "description": "Registered office postcode, or the start of one (UK and France)", "schema": { "type": "string" }, "example": "LS1" }, { "name": "q", "in": "query", "required": false, "description": "Part of the company name, 3 characters or more", "schema": { "type": "string" }, "example": "freight" }, { "name": "page", "in": "query", "required": false, "description": "Page number, from 1", "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "description": "Results a page, 25 if left out, up to your plan's maximum", "schema": { "type": "integer" } }, { "name": "cursor", "in": "query", "required": false, "description": "next_cursor from the page before", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Case" } }, "meta": { "type": "object" } } }, "example": { "data": [ { "id": "cs_5z3tyna7", "country": "gb", "company": { "register_number": "10144457", "name": "BOLD STRIPE SOLUTIONS LIMITED", "town": "BIRMINGHAM", "postcode": "B4 6EQ", "sic": "70229", "sector": { "code": "M", "label": "Professional, scientific and technical activities" }, "register_status": "Active", "nature_of_business": null }, "procedure": "members_voluntary_liquidation", "procedure_label": "Members' voluntary liquidation", "status": "open", "status_label": "Proceedings are open", "petition_on": null, "opened_on": "2026-10-30", "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": 2, "last_activity_on": "2026-10-30" }, { "id": "cs_7tacdyz0", "country": "gb", "company": { "register_number": "08539599", "name": "FORT AMHERST HALLOWEEN LIMITED", "town": "CHATHAM", "postcode": "ME4 4UB", "sic": "91030", "sector": { "code": "R", "label": "Arts, entertainment and recreation" }, "register_status": "Active", "nature_of_business": null }, "procedure": "creditors_voluntary_liquidation", "procedure_label": "Creditors' voluntary liquidation", "status": "open", "status_label": "Proceedings are open", "petition_on": null, "opened_on": "2026-10-30", "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": 100000, "total_exact": false, "total_pages": null, "next_page": 2, "prev_page": null } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/cases/{case_id}": { "get": { "summary": "One case, with every notice in it in date order where the country publishes notices", "operationId": "case", "description": "Plans: Developer, Professional, Intel. Docs: https://insolvencyapi.com/documentation/case", "parameters": [ { "name": "case_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/CaseWithNotices" }, "meta": { "type": "object" } } }, "example": { "data": { "id": "cs_k54b7nzt", "country": "gb", "company": { "register_number": "04542915", "name": "KMJ VENTILATION LIMITED", "town": "WORCESTERSHIRE", "postcode": "WR9 7DQ", "sic": "43220", "sector": { "code": "F", "label": "Construction" }, "register_status": "Active", "nature_of_business": null }, "procedure": "members_voluntary_liquidation", "procedure_label": "Members' voluntary liquidation", "status": "open", "status_label": "Proceedings are open", "petition_on": null, "opened_on": "2026-10-30", "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": 3, "last_activity_on": "2026-10-30", "notices": [ { "id": "nt_cegh63t0", "case_id": "cs_k54b7nzt", "country": "gb", "step": "notice_to_creditors", "step_label": "Notice to creditors to prove debts", "procedure": "members_voluntary_liquidation", "published_on": "2026-10-30", "event_on": null, "company": { "register_number": "04542915", "name": "KMJ VENTILATION LIMITED" }, "claims_deadline": null, "hearing": null, "court": null, "court_case_ref": null, "details": [] }, { "id": "nt_275e60z4", "case_id": "cs_k54b7nzt", "country": "gb", "step": "liquidator_appointed", "step_label": "Liquidator appointed", "procedure": "members_voluntary_liquidation", "published_on": "2026-10-30", "event_on": null, "company": { "register_number": "04542915", "name": "KMJ VENTILATION LIMITED" }, "claims_deadline": null, "hearing": null, "court": null, "court_case_ref": null, "details": [] } ] }, "meta": [] } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/cases/{case_id}/notices": { "get": { "summary": "Every notice in one case, oldest first", "operationId": "case_notices", "description": "Plans: Developer, Professional, Intel. Docs: https://insolvencyapi.com/documentation/case-notices", "parameters": [ { "name": "case_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "description": "Page number, from 1", "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "description": "Results a page, 25 if left out, up to your plan's maximum", "schema": { "type": "integer" } }, { "name": "cursor", "in": "query", "required": false, "description": "next_cursor from the page before", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Notice" } }, "meta": { "type": "object" } } }, "example": { "data": [ { "id": "nt_cegh63t0", "case_id": "cs_k54b7nzt", "country": "gb", "step": "notice_to_creditors", "step_label": "Notice to creditors to prove debts", "procedure": "members_voluntary_liquidation", "published_on": "2026-10-30", "event_on": null, "company": { "register_number": "04542915", "name": "KMJ VENTILATION LIMITED" }, "claims_deadline": null, "hearing": null, "court": null, "court_case_ref": null, "details": [] }, { "id": "nt_275e60z4", "case_id": "cs_k54b7nzt", "country": "gb", "step": "liquidator_appointed", "step_label": "Liquidator appointed", "procedure": "members_voluntary_liquidation", "published_on": "2026-10-30", "event_on": null, "company": { "register_number": "04542915", "name": "KMJ VENTILATION LIMITED" }, "claims_deadline": null, "hearing": null, "court": null, "court_case_ref": null, "details": [] } ], "meta": { "count": 3, "next_cursor": null, "page": 1, "limit": 25, "total": 3, "total_exact": true, "total_pages": 1, "next_page": null, "prev_page": null } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/notices": { "get": { "summary": "Every published notice, newest first, in the countries that publish notices (UK and France)", "operationId": "notices", "description": "Plans: Developer, Professional, Intel. Docs: https://insolvencyapi.com/documentation/notices", "parameters": [ { "name": "country", "in": "query", "required": false, "description": "gb, fr or both. Any of: gb, fr", "schema": { "type": "string" }, "example": "fr" }, { "name": "step", "in": "query", "required": false, "description": "One or more notice steps, see /v1/vocabulary. Any of: petition_filed, petition_served, petition_dismissed, winding_up_order, resolution_to_wind_up, liquidator_appointed, liquidator_released, administrator_appointed, administration_order, receiver_appointed, creditors_meeting, notice_to_creditors, notice_to_members, deemed_consent, decision_procedure, intended_dividend, dividend, annual_meeting, final_meeting, public_examination, moratorium_started, moratorium_ended, prohibited_name, cross_border, opening_judgment, plan_adopted, conversion, closing_judgment, claims_list_filed, plan_changed, plan_cancelled, extension, distribution_plan_filed, reopened, opening_withdrawn, appeal_decision, officeholders_appointed, other", "schema": { "type": "string" }, "example": "winding_up_order" }, { "name": "procedure", "in": "query", "required": false, "description": "One or more procedures. Any of: compulsory_liquidation, creditors_voluntary_liquidation, members_voluntary_liquidation, administration, administrative_receivership, receivership, moratorium, judicial_liquidation, judicial_reorganisation, safeguard, conciliation, other", "schema": { "type": "string" }, "example": "judicial_liquidation" }, { "name": "published_from", "in": "query", "required": false, "description": "Published on or after", "schema": { "type": "string", "format": "date" }, "example": "2026-10-13" }, { "name": "published_to", "in": "query", "required": false, "description": "Published on or before", "schema": { "type": "string", "format": "date" }, "example": "2026-10-14" }, { "name": "page", "in": "query", "required": false, "description": "Page number, from 1", "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "description": "Results a page, 25 if left out, up to your plan's maximum", "schema": { "type": "integer" } }, { "name": "cursor", "in": "query", "required": false, "description": "next_cursor from the page before", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Notice" } }, "meta": { "type": "object" } } }, "example": { "data": [ { "id": "nt_5n8e98xr", "case_id": "cs_6mdtsgbd", "country": "fr", "step": "claims_list_filed", "step_label": "List of claims filed with the court", "procedure": "judicial_liquidation", "published_on": "2026-10-30", "event_on": "2026-10-21", "company": { "register_number": "823797618", "name": "SAS MB IMPORT DISTRIBUTION LA REUNION" }, "claims_deadline": null, "hearing": null, "court": "TRIBUNAL MIXTE DE COMMERCE DE SAINT-DENIS DE LA RÉUNION", "court_case_ref": null, "details": { "registered_office": "20 b rue Felix Guyon, 97400 Saint-Denis", "nature_of_business": "import export négoce distribution d'accessoires pour fumeur, narguilés, enseignes, site web, vente au détail textiles, restauration, boissons. vente d'accessoires de fumeurs et narquilés.", "legal_form": "Société par Actions Simplifiée" } }, { "id": "nt_ghcejkph", "case_id": "cs_mpa8rmrk", "country": "fr", "step": "claims_list_filed", "step_label": "List of claims filed with the court", "procedure": "judicial_liquidation", "published_on": "2026-10-30", "event_on": "2026-10-09", "company": { "register_number": "895048148", "name": "SARL QUINCAILLERIE MAILLOT" }, "claims_deadline": null, "hearing": null, "court": "TRIBUNAL MIXTE DE COMMERCE DE SAINT-DENIS DE LA RÉUNION", "court_case_ref": null, "details": { "registered_office": "57 rue Michel Debré, 97433 Salazie", "nature_of_business": "quincaillerie générale, vente d'aliments pour animaux, vente de produits phytosanitaires et agricoles, bazar, vente de matériaux de construction.", "legal_form": "Société à Responsabilité Limitée" } } ], "meta": { "count": 2, "next_cursor": "eyJvIjoyLCJwIjoyfQ", "page": 1, "limit": 2, "total": 100000, "total_exact": false, "total_pages": null, "next_page": 2, "prev_page": null } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/claims-deadlines": { "get": { "summary": "Cases where creditors can still send their claims, soonest deadline first (France in full; UK deadlines are rare)", "operationId": "claims_deadlines", "description": "Plans: Professional, Intel. Docs: https://insolvencyapi.com/documentation/claims-deadlines", "parameters": [ { "name": "country", "in": "query", "required": false, "description": "gb, fr or both (UK deadlines are rare). Any of: gb, fr", "schema": { "type": "string" }, "example": "fr" }, { "name": "from", "in": "query", "required": false, "description": "Deadlines on or after (today if left out)", "schema": { "type": "string", "format": "date" }, "example": "2026-10-14" }, { "name": "before", "in": "query", "required": false, "description": "Deadlines on or before (60 days ahead if left out)", "schema": { "type": "string", "format": "date" }, "example": "2026-11-30" }, { "name": "register_number", "in": "query", "required": false, "description": "Only these companies, comma separated, such as the customers on your books", "schema": { "type": "string" }, "example": "09412377,812334905" }, { "name": "page", "in": "query", "required": false, "description": "Page number, from 1", "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "description": "Results a page, 25 if left out, up to your plan's maximum", "schema": { "type": "integer" } }, { "name": "cursor", "in": "query", "required": false, "description": "next_cursor from the page before", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Case" } }, "meta": { "type": "object" } } }, "example": { "data": [ { "id": "cs_h6wbb4yk", "country": "fr", "company": { "register_number": "534010293", "name": "RESTOALENCON", "town": "Saint-Barthélemy-d'Anjou", "postcode": "49124", "sic": "56.10A", "sector": { "code": "I", "label": "Accommodation and food services" }, "register_status": "Active", "nature_of_business": "Restauration traditionnelle" }, "procedure": "judicial_reorganisation", "procedure_label": "Judicial reorganisation", "status": "open", "status_label": "Proceedings are open", "petition_on": null, "opened_on": "2026-07-01", "opened_after": null, "opened_precision": "day", "closed_on": null, "closed_by": null, "claims_deadline": "2026-10-31", "next_hearing": null, "last_hearing": null, "court": "Tribunal de Commerce d'Angers", "court_case_ref": null, "first_notice_on": "2026-07-10", "last_notice_on": "2026-08-31", "notice_count": 2, "last_activity_on": "2026-08-31", "days_left": 0 }, { "id": "cs_b3vmygrn", "country": "fr", "company": { "register_number": "985296615", "name": "GLT BATIMENT", "town": "Saint-Mandé", "postcode": "94160", "sic": "41.20A", "sector": { "code": "F", "label": "Construction" }, "register_status": "Active", "nature_of_business": "Entreprise générale du bâtiment, maçonnerie et autres travaux de construction rénovation, couverture, plomberie chauffage, travaux d'installation électrique et d'isolation." }, "procedure": "judicial_reorganisation", "procedure_label": "Judicial reorganisation", "status": "open", "status_label": "Proceedings are open", "petition_on": null, "opened_on": "2026-07-27", "opened_after": null, "opened_precision": "day", "closed_on": null, "closed_by": null, "claims_deadline": "2026-10-31", "next_hearing": null, "last_hearing": null, "court": "Tribunal de Commerce de Meaux", "court_case_ref": null, "first_notice_on": "2026-08-12", "last_notice_on": "2026-08-31", "notice_count": 2, "last_activity_on": "2026-08-31", "days_left": 0 } ], "meta": { "count": 2, "next_cursor": "eyJvIjoyLCJwIjoyfQ", "page": 1, "limit": 2, "total": 9996, "total_exact": true, "total_pages": 4998, "next_page": 2, "prev_page": null, "from": "2026-10-31", "before": "2026-12-30" } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/petitions": { "get": { "summary": "UK winding-up petitions filed and not yet decided, newest first", "operationId": "petitions", "description": "Plans: Professional, Intel. Docs: https://insolvencyapi.com/documentation/petitions", "parameters": [ { "name": "filed_from", "in": "query", "required": false, "description": "Petitions filed on or after", "schema": { "type": "string", "format": "date" }, "example": "2026-10-01" }, { "name": "hearing_from", "in": "query", "required": false, "description": "Next hearing on or after, where published", "schema": { "type": "string", "format": "date" }, "example": "" }, { "name": "hearing_to", "in": "query", "required": false, "description": "Next hearing on or before, where published", "schema": { "type": "string", "format": "date" }, "example": "" }, { "name": "q", "in": "query", "required": false, "description": "Part of the company name, 3 characters or more", "schema": { "type": "string" }, "example": "" }, { "name": "page", "in": "query", "required": false, "description": "Page number, from 1", "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "description": "Results a page, 25 if left out, up to your plan's maximum", "schema": { "type": "integer" } }, { "name": "cursor", "in": "query", "required": false, "description": "next_cursor from the page before", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Case" } }, "meta": { "type": "object" } } }, "example": { "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 } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/feed/daily": { "get": { "summary": "Every notice published on one day, for loading in bulk, up to 1000 a page", "operationId": "daily_feed", "description": "Plans: Intel. Docs: https://insolvencyapi.com/documentation/daily-feed", "parameters": [ { "name": "date", "in": "query", "required": true, "description": "The publication day", "schema": { "type": "string", "format": "date" }, "example": "2026-10-13" }, { "name": "country", "in": "query", "required": false, "description": "gb, fr or both. Any of: gb, fr", "schema": { "type": "string" }, "example": "gb" }, { "name": "page", "in": "query", "required": false, "description": "Page number, from 1", "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "description": "Results a page, 25 if left out, up to your plan's maximum", "schema": { "type": "integer" } }, { "name": "cursor", "in": "query", "required": false, "description": "next_cursor from the page before", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Notice" } }, "meta": { "type": "object" } } }, "example": { "data": [ { "id": "nt_pmn95kwn", "case_id": "cs_d1kmew6t", "country": "gb", "step": "petition_filed", "step_label": "Winding-up petition filed", "procedure": "compulsory_liquidation", "published_on": "2026-10-30", "event_on": "2026-09-23", "company": { "register_number": "07754344", "name": "BENFLEET PLASTIC WAREHOUSE LIMITED" }, "claims_deadline": null, "hearing": { "date": "2026-11-11", "local_time": "10:30", "timezone": "Europe/London" }, "court": "High Court of Justice, Business and Property Courts of England and Wales", "court_case_ref": "CR-2026-007229", "details": { "petitioner": "a creditor" } }, { "id": "nt_0tz6yssw", "case_id": "cs_amhrjp4r", "country": "gb", "step": "petition_filed", "step_label": "Winding-up petition filed", "procedure": "compulsory_liquidation", "published_on": "2026-10-30", "event_on": "2026-09-24", "company": { "register_number": "04593308", "name": "ENVIRON AUDIO LIMITED" }, "claims_deadline": null, "hearing": { "date": "2026-11-11", "local_time": null, "timezone": "Europe/London" }, "court": "High Court of Justice, Business and Property Courts of England and Wales", "court_case_ref": "CR-2026-007423", "details": [] } ], "meta": { "count": 2, "next_cursor": "eyJvIjoyLCJwIjoyfQ", "page": 1, "limit": 2, "total": 1832, "total_exact": true, "total_pages": 916, "next_page": 2, "prev_page": null } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/companies/{country}/{register_number}": { "get": { "summary": "Is this company in insolvency? One company by its register number, with every case it has", "operationId": "company", "description": "Plans: Developer, Professional, Intel. Docs: https://insolvencyapi.com/documentation/company", "parameters": [ { "name": "country", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "register_number", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Company" }, "meta": { "type": "object" } } }, "example": { "data": { "country": "gb", "register_number": "10144457", "name": "BOLD STRIPE SOLUTIONS LIMITED", "register": { "status": "Active", "category": "Private Limited Company", "incorporated_on": "2016-04-25", "dissolved_on": null, "sic": "70229", "sic_label": "Management consultancy activities other than financial management", "town": "BIRMINGHAM", "postcode": "B4 6EQ", "filings": { "accounts_type": "TOTAL EXEMPTION FULL", "accounts_made_up_to": "2026-09-04", "accounts_due_on": "2028-06-04", "accounts_overdue": false, "accounts_days_late": 0, "confirmation_made_up_to": "2026-04-22", "confirmation_due_on": "2027-05-06", "confirmation_overdue": false }, "as_of": "2026-10-01" }, "accounts": { "currency": "GBP", "warning_signs": { "net_liabilities": false, "current_liabilities_exceed_assets": false, "net_assets_fell": true }, "periods": [ { "period_end": "2026-09-04", "employees": 1, "turnover": null, "profit_loss": null, "fixed_assets": null, "current_assets": 370621, "cash": 369673, "debtors": 948, "inventories": null, "creditors_within_one_year": -255, "trade_creditors": null, "bank_borrowings": null, "tax_payable": null, "net_current_assets": 370876, "total_assets_less_current_liabilities": 370876, "net_assets": 370876 }, { "period_end": "2026-04-30", "employees": 1, "turnover": null, "profit_loss": null, "fixed_assets": null, "current_assets": 384434, "cash": 384398, "debtors": 36, "inventories": null, "creditors_within_one_year": 12852, "trade_creditors": null, "bank_borrowings": null, "tax_payable": null, "net_current_assets": 371582, "total_assets_less_current_liabilities": 371582, "net_assets": 371582 }, { "period_end": "2025-04-30", "employees": 1, "turnover": null, "profit_loss": null, "fixed_assets": null, "current_assets": 352276, "cash": 344341, "debtors": 7935, "inventories": null, "creditors_within_one_year": 29677, "trade_creditors": null, "bank_borrowings": null, "tax_payable": null, "net_current_assets": 322599, "total_assets_less_current_liabilities": 322599, "net_assets": 322599 } ] }, "in_insolvency": true, "open_case_count": 1, "cases": [ { "id": "cs_5z3tyna7", "country": "gb", "company": { "register_number": "10144457", "name": "BOLD STRIPE SOLUTIONS LIMITED", "town": "BIRMINGHAM", "postcode": "B4 6EQ", "sic": "70229", "sector": { "code": "M", "label": "Professional, scientific and technical activities" }, "register_status": "Active", "nature_of_business": null }, "procedure": "members_voluntary_liquidation", "procedure_label": "Members' voluntary liquidation", "status": "open", "status_label": "Proceedings are open", "petition_on": null, "opened_on": "2026-10-30", "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": 2, "last_activity_on": "2026-10-30" } ], "checked_at": "2026-10-31T00:51:58Z" }, "meta": [] } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/companies/search": { "get": { "summary": "Companies with insolvency cases whose name matches, in one country or all 18", "operationId": "company_search", "description": "Plans: Developer, Professional, Intel. Docs: https://insolvencyapi.com/documentation/company-search", "parameters": [ { "name": "q", "in": "query", "required": true, "description": "Part of the company name, 3 characters or more", "schema": { "type": "string" }, "example": "freight" }, { "name": "country", "in": "query", "required": false, "description": "One or more countries, comma separated. Any of: gb, fr, at, cz, ee, fi, hr, ie, lv, no, pt, ro, sk, es, se, pl, us, lt, de, ch, ua, si, kr", "schema": { "type": "string" }, "example": "gb,fr" }, { "name": "page", "in": "query", "required": false, "description": "Page number, from 1", "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "description": "Results a page, 25 if left out, up to your plan's maximum", "schema": { "type": "integer" } }, { "name": "cursor", "in": "query", "required": false, "description": "next_cursor from the page before", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/CompanySummary" } }, "meta": { "type": "object" } } }, "example": { "data": [ { "country": "gb", "register_number": "06632666", "name": "FREIGHT LOGISTICS WAREHOUSING LTD.", "in_insolvency": true, "case_count": 1, "last_activity_on": "2026-10-30" }, { "country": "gb", "register_number": "14393061", "name": "DDP FREIGHT (UK) LTD", "in_insolvency": true, "case_count": 1, "last_activity_on": "2026-10-22" } ], "meta": { "count": 2, "next_cursor": "eyJvIjoyLCJwIjoyfQ", "page": 1, "limit": 2, "total": 449, "total_exact": true, "total_pages": 225, "next_page": 2, "prev_page": null, "searched": "The 5,000 most recently active matching cases in each store" } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/companies/check": { "post": { "summary": "Check up to 100 companies in one call, by register number or by name; each company counts as one call", "operationId": "company_check", "description": "Plans: Developer, Professional, Intel. Docs: https://insolvencyapi.com/documentation/company-check", "parameters": [ { "name": "page", "in": "query", "required": false, "description": "Page number, from 1", "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "description": "Results a page, 25 if left out, up to your plan's maximum", "schema": { "type": "integer" } }, { "name": "cursor", "in": "query", "required": false, "description": "next_cursor from the page before", "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/CheckResult" } }, "meta": { "type": "object" } } }, "example": { "data": [ { "index": 0, "matched": true, "match": "register_number", "company": { "country": "gb", "register_number": "10144457", "name": "BOLD STRIPE SOLUTIONS LIMITED" }, "in_insolvency": true, "cases": [ { "id": "cs_5z3tyna7", "country": "gb", "company": { "register_number": "10144457", "name": "BOLD STRIPE SOLUTIONS LIMITED", "town": "BIRMINGHAM", "postcode": "B4 6EQ", "sic": "70229", "sector": { "code": "M", "label": "Professional, scientific and technical activities" }, "register_status": "Active", "nature_of_business": null }, "procedure": "members_voluntary_liquidation", "procedure_label": "Members' voluntary liquidation", "status": "open", "status_label": "Proceedings are open", "petition_on": null, "opened_on": "2026-10-30", "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": 2, "last_activity_on": "2026-10-30" } ] }, { "index": 1, "matched": false, "match": "none", "company": null, "in_insolvency": false, "cases": [], "countries_checked": 23 } ], "meta": { "count": 2, "matched": 1, "calls_counted": 2, "checked_at": "2026-10-31T00:52:20Z" } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "companies": { "type": "array", "maxItems": 100, "items": { "type": "object", "properties": { "country": { "type": "string", "example": "gb" }, "register_number": { "type": "string" }, "name": { "type": "string" }, "postcode": { "type": "string" } } } } } } } } } } }, "/v1/stats/monthly": { "get": { "summary": "Companies entering insolvency each month, by country, with the economy beside them", "operationId": "stats_monthly", "description": "Plans: Professional, Intel. Docs: https://insolvencyapi.com/documentation/stats-monthly", "parameters": [ { "name": "country", "in": "query", "required": true, "description": "One or more countries, including Belgium and Denmark's official counts. Any of: gb, fr, at, cz, ee, fi, hr, ie, lv, no, pt, ro, sk, es, se, pl, us, lt, de, ch, ua, si, kr, be, dk", "schema": { "type": "string" }, "example": "fr" }, { "name": "from", "in": "query", "required": false, "description": "From this month, YYYY-MM", "schema": { "type": "string" }, "example": "2025-01" }, { "name": "to", "in": "query", "required": false, "description": "To this month, YYYY-MM", "schema": { "type": "string" }, "example": "2026-09" }, { "name": "procedure", "in": "query", "required": false, "description": "Only these procedures (countries with cases). Any of: compulsory_liquidation, creditors_voluntary_liquidation, members_voluntary_liquidation, administration, administrative_receivership, receivership, moratorium, judicial_liquidation, judicial_reorganisation, safeguard, conciliation, other, bankruptcy, insolvency, liquidation, liquidation_unspecified, restructuring, forced_dissolution, external_administration", "schema": { "type": "string" }, "example": "" }, { "name": "with", "in": "query", "required": false, "description": "Figures beside the counts. Any of: unemployment, inflation, interest_rate", "schema": { "type": "string" }, "example": "unemployment" } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/StatMonth" } }, "meta": { "type": "object" } } }, "example": { "data": [ { "country": "fr", "month": "2026-07", "held_as": "cases", "cases": 6657, "closed": 5802, "unemployment_rate": 8.3 }, { "country": "fr", "month": "2026-08", "held_as": "cases", "cases": 1933, "closed": 1337, "unemployment_rate": 8.2 } ], "meta": { "count": 4, "with": [ "unemployment" ], "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." } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/stats/official": { "get": { "summary": "The official counts and the official quarterly index held, by country and period, monthly, quarterly or yearly as published", "operationId": "stats_official", "description": "Plans: Professional, Intel. Docs: https://insolvencyapi.com/documentation/stats-official", "parameters": [ { "name": "country", "in": "query", "required": false, "description": "Only these countries", "schema": { "type": "string" }, "example": "fi,no" }, { "name": "frequency", "in": "query", "required": false, "description": "M (monthly), Q (quarterly) or Y (yearly)", "schema": { "type": "string", "enum": [ "M", "Q", "Y" ] }, "example": "" }, { "name": "from", "in": "query", "required": false, "description": "From this period: a month (2024-01), a quarter (2024-Q1) or a year (2024)", "schema": { "type": "string" }, "example": "2020" }, { "name": "to", "in": "query", "required": false, "description": "To this period, in the same forms", "schema": { "type": "string" }, "example": "" } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/OfficialCount" } }, "meta": { "type": "object" } } }, "example": { "data": [ { "country": "fi", "measure": "corporate_insolvencies_index", "frequency": "Q", "period": "2023-Q1", "value": 1462, "unit": "index, 2021 = 100" }, { "country": "fi", "measure": "corporate_insolvencies_index", "frequency": "Q", "period": "2023-Q2", "value": 1236, "unit": "index, 2021 = 100" } ], "meta": { "countries": [ "at", "au", "be", "ca", "ch", "cz", "de", "dk", "ee", "es", "fi", "fr", "gb", "gf", "gp", "hk", "hr", "is", "it", "jp", "lu", "lv", "mq", "nl", "no", "nz", "pl", "pt", "re", "ro", "se", "sg", "si", "sj", "sk", "us", "za" ], "note": "Official counts and the official quarterly index, as published. Our own monthly counts from cases are on /v1/stats/monthly." } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/stats/sectors": { "get": { "summary": "Cases by sector, with the companies on the register in each and a rate for every 10,000", "operationId": "stats_sectors", "description": "Plans: Intel. Docs: https://insolvencyapi.com/documentation/stats-sectors", "parameters": [ { "name": "country", "in": "query", "required": true, "description": "gb or fr", "schema": { "type": "string", "enum": [ "gb", "fr" ] }, "example": "gb" }, { "name": "months", "in": "query", "required": false, "description": "How many months back, 1 to 60 (12 if left out)", "schema": { "type": "integer" }, "example": "12" }, { "name": "procedure", "in": "query", "required": false, "description": "Only these procedures. Any of: compulsory_liquidation, creditors_voluntary_liquidation, members_voluntary_liquidation, administration, administrative_receivership, receivership, moratorium, judicial_liquidation, judicial_reorganisation, safeguard, conciliation, other", "schema": { "type": "string" }, "example": "" } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/StatSector" } }, "meta": { "type": "object" } } }, "example": { "data": [ { "sector": "F", "label": "Construction", "cases": 4931, "closed": 5001, "companies": 571869, "per_10000_companies": 86.2, "share_of_cases": 0.148 }, { "sector": "G", "label": "Wholesale and retail trade, repair of motor vehicles", "cases": 4229, "closed": 4278, "companies": 747054, "per_10000_companies": 56.6, "share_of_cases": 0.127 } ], "meta": { "country": "gb", "months": { "from": "2025-11", "to": "2026-10", "count": 12 }, "register": "UK company register, live companies today", "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." } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/stats/regions": { "get": { "summary": "Cases by UK postcode area or French department", "operationId": "stats_regions", "description": "Plans: Intel. Docs: https://insolvencyapi.com/documentation/stats-regions", "parameters": [ { "name": "country", "in": "query", "required": true, "description": "gb or fr", "schema": { "type": "string", "enum": [ "gb", "fr" ] }, "example": "fr" }, { "name": "months", "in": "query", "required": false, "description": "How many months back, 1 to 60 (12 if left out)", "schema": { "type": "integer" }, "example": "12" }, { "name": "sector", "in": "query", "required": false, "description": "One sector section, A to U", "schema": { "type": "string", "enum": [ "A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U" ] }, "example": "" } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/StatRegion" } }, "meta": { "type": "object" } } }, "example": { "data": [ { "region": "75", "cases": 5128, "closed": 4443, "share_of_cases": 0.069 }, { "region": "13", "cases": 3118, "closed": 3208, "share_of_cases": 0.042 } ], "meta": { "country": "fr", "region_is": "French department", "months": { "from": "2025-11", "to": "2026-10", "count": 12 }, "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." } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/stats/drivers": { "get": { "summary": "Who started the cases (directors, the tax authority, another creditor, a lender, the court), by month, region or sector", "operationId": "stats_drivers", "description": "Plans: Intel. Docs: https://insolvencyapi.com/documentation/stats-drivers", "parameters": [ { "name": "country", "in": "query", "required": true, "description": "gb, fr or both. Any of: gb, fr", "schema": { "type": "string" }, "example": "gb" }, { "name": "by", "in": "query", "required": false, "description": "Split by month, region or sector (month if left out)", "schema": { "type": "string", "enum": [ "month", "region", "sector" ] }, "example": "month" }, { "name": "months", "in": "query", "required": false, "description": "How many months back, 1 to 60 (12 if left out)", "schema": { "type": "integer" }, "example": "12" }, { "name": "from", "in": "query", "required": false, "description": "From this month, YYYY-MM (instead of months)", "schema": { "type": "string" }, "example": "" }, { "name": "to", "in": "query", "required": false, "description": "To this month, YYYY-MM", "schema": { "type": "string" }, "example": "" }, { "name": "region", "in": "query", "required": false, "description": "One UK postcode area (LS) or French department (75)", "schema": { "type": "string" }, "example": "" }, { "name": "sector", "in": "query", "required": false, "description": "One sector section, A to U", "schema": { "type": "string", "enum": [ "A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U" ] }, "example": "" }, { "name": "driver", "in": "query", "required": false, "description": "Only these drivers, see /v1/vocabulary. Any of: directors_resolution, tax_authority_petition, public_interest_petition, creditor_petition, petitioner_not_given, administration_by_directors, administration_by_lender, administration_by_court, administration_other, receiver_by_lender, directors_moratorium, solvent_wind_up, early_protection, court_rescue, liquidation, other", "schema": { "type": "string" }, "example": "" } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/StatDriver" } }, "meta": { "type": "object" } } }, "example": { "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." } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/stats/durations": { "get": { "summary": "How long cases last, opening to closing: the median and quartiles by year closed", "operationId": "stats_durations", "description": "Plans: Intel. Docs: https://insolvencyapi.com/documentation/stats-durations", "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more countries, comma separated. Any of: gb, fr, at, cz, ee, fi, hr, ie, lv, no, pt, ro, sk, es, se, pl, us, lt, de, ch, ua, si, kr", "schema": { "type": "string" }, "example": "gb,fr" }, { "name": "procedure", "in": "query", "required": false, "description": "Only these procedures. Any of: compulsory_liquidation, creditors_voluntary_liquidation, members_voluntary_liquidation, administration, administrative_receivership, receivership, moratorium, judicial_liquidation, judicial_reorganisation, safeguard, conciliation, other, bankruptcy, insolvency, liquidation, liquidation_unspecified, restructuring, forced_dissolution, external_administration", "schema": { "type": "string" }, "example": "" }, { "name": "from", "in": "query", "required": false, "description": "Closed in or after this year, YYYY", "schema": { "type": "string" }, "example": "2020" }, { "name": "to", "in": "query", "required": false, "description": "Closed in or before this year, YYYY", "schema": { "type": "string" }, "example": "2026" } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/StatDuration" } }, "meta": { "type": "object" } } }, "example": { "data": [ { "country": "fr", "procedure": "judicial_liquidation", "closed_in": 2008, "cases": 2034, "median_days": 231, "quarter_days": 151, "three_quarters_days": 280 }, { "country": "fr", "procedure": "judicial_liquidation", "closed_in": 2009, "cases": 12455, "median_days": 365, "quarter_days": 283, "three_quarters_days": 464 } ], "meta": { "count": 19, "counts": "Cases with their opening and closing both held to the day; years with fewer than 5 cases are left out", "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." } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/stats/outcomes": { "get": { "summary": "How the cases opened each year have ended so far", "operationId": "stats_outcomes", "description": "Plans: Intel. Docs: https://insolvencyapi.com/documentation/stats-outcomes", "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more countries, comma separated. Any of: gb, fr, at, cz, ee, fi, hr, ie, lv, no, pt, ro, sk, es, se, pl, us, lt, de, ch, ua, si, kr", "schema": { "type": "string" }, "example": "gb,fr" }, { "name": "procedure", "in": "query", "required": false, "description": "Only these procedures. Any of: compulsory_liquidation, creditors_voluntary_liquidation, members_voluntary_liquidation, administration, administrative_receivership, receivership, moratorium, judicial_liquidation, judicial_reorganisation, safeguard, conciliation, other, bankruptcy, insolvency, liquidation, liquidation_unspecified, restructuring, forced_dissolution, external_administration", "schema": { "type": "string" }, "example": "" }, { "name": "from", "in": "query", "required": false, "description": "Opened in or after this year, YYYY", "schema": { "type": "string" }, "example": "2020" }, { "name": "to", "in": "query", "required": false, "description": "Opened in or before this year, YYYY", "schema": { "type": "string" }, "example": "2026" } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/StatOutcome" } }, "meta": { "type": "object" } } }, "example": { "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." } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/stats/trends": { "get": { "summary": "What is rising faster than usual: the last 3 months against the same months in the 3 years before", "operationId": "stats_trends", "description": "Plans: Intel. Docs: https://insolvencyapi.com/documentation/stats-trends", "parameters": [ { "name": "country", "in": "query", "required": true, "description": "One or more countries. Any of: gb, fr, at, cz, ee, fi, hr, ie, lv, no, pt, ro, sk, es, se, pl, us, lt, de, ch, ua, si, kr", "schema": { "type": "string" }, "example": "gb,fr,cz" }, { "name": "sector", "in": "query", "required": false, "description": "Split by these sector sections (UK and France). Any of: A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U", "schema": { "type": "string" }, "example": "" }, { "name": "min_change", "in": "query", "required": false, "description": "Only changes at least this big either way, such as 0.2 for 20%", "schema": { "type": "number" }, "example": "0.1" } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/StatTrend" } }, "meta": { "type": "object" } } }, "example": { "data": [ { "country": "fr", "sector": null, "sector_label": null, "last_3_months": 16307, "usual": 14907, "years_compared": 3, "change": 0.094, "direction": "steady" }, { "country": "cz", "sector": null, "sector_label": null, "last_3_months": 3697, "usual": 4159, "years_compared": 3, "change": -0.111, "direction": "falling" } ], "meta": { "count": 3, "months": { "from": "2026-07", "to": "2026-09" }, "compared_with": "the same three months in each of the three years before", "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." } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/stats/compare": { "get": { "summary": "Countries side by side: cases in a span of months, and for every 10,000 companies where the register is held", "operationId": "stats_compare", "description": "Plans: Intel. Docs: https://insolvencyapi.com/documentation/stats-compare", "parameters": [ { "name": "country", "in": "query", "required": true, "description": "Two or more countries. Any of: gb, fr, at, cz, ee, fi, hr, ie, lv, no, pt, ro, sk, es, se, pl, us, lt, de, ch, ua, si, kr", "schema": { "type": "string" }, "example": "gb,fr" }, { "name": "months", "in": "query", "required": false, "description": "How many months back, 1 to 60 (12 if left out)", "schema": { "type": "integer" }, "example": "12" } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/StatCompare" } }, "meta": { "type": "object" } } }, "example": { "data": [ { "country": "fr", "name": "France", "cases": 74148, "cases_per_month": 6179, "companies": 8296553, "per_10000_companies": 89.4 }, { "country": "gb", "name": "United Kingdom", "cases": 33721, "cases_per_month": 2810.1, "companies": 5472974, "per_10000_companies": 61.6 } ], "meta": { "months": { "from": "2025-11", "to": "2026-10", "count": 12 }, "rates": "per_10000_companies is given where the company register is held (the UK and France); elsewhere it is null and cases_per_month compares them.", "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." } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/coverage": { "get": { "summary": "Every country held: how many cases, how far back, and when it was last read", "operationId": "coverage", "description": "Plans: Developer, Professional, Intel. Docs: https://insolvencyapi.com/documentation/coverage", "parameters": [ { "name": "country", "in": "query", "required": false, "description": "Only these countries. Any of: gb, fr, at, cz, ee, fi, hr, ie, lv, no, pt, ro, sk, es, se, pl, us, lt, de, ch, ua, si, kr, be, dk", "schema": { "type": "string" }, "example": "" } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Coverage" } }, "meta": { "type": "object" } } }, "example": { "data": [ { "country": "gb", "name": "United Kingdom", "held_as": "cases", "cases": 717978, "active_cases": 237084, "earliest_on": "1921-06-23", "latest_on": "2026-10-30", "notices": 1678029, "court_case_ref": true, "claims_deadlines": true, "opened_precision": "day", "sample": false, "last_read": "2026-10-30T18:05:20Z" }, { "country": "fr", "name": "France", "held_as": "cases", "cases": 1254378, "active_cases": 258080, "earliest_on": "1985-12-27", "latest_on": "2026-10-30", "notices": 2495931, "court_case_ref": false, "claims_deadlines": true, "opened_precision": "day", "sample": false, "last_read": "2026-10-30T06:53:35Z" } ], "meta": { "count": 2, "counted_at": "2026-10-31T00:51:09Z" } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/gaps": { "get": { "summary": "Every place in the world: what is held, what is missing and what we are doing about it. Free, no key needed, never counted", "operationId": "gaps", "description": "Free, no key needed, never counted. Docs: https://insolvencyapi.com/documentation/gaps", "parameters": [ { "name": "kind", "in": "query", "required": false, "description": "Only places of this kind", "schema": { "type": "string", "enum": [ "complete", "missing", "behind", "unchecked", "nomonth", "none" ] }, "example": "" } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Gap" } }, "meta": { "type": "object" } } }, "example": { "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" } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [] } }, "/v1/gaps/{country}": { "get": { "summary": "One country in full: every month missing, not published or withheld, and its open issue. Free, no key needed, never counted", "operationId": "gap_country", "description": "Free, no key needed, never counted. Docs: https://insolvencyapi.com/documentation/gap-country", "parameters": [ { "name": "country", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/GapCountry" }, "meta": { "type": "object" } } }, "example": { "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" } } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [] } }, "/v1/vocabulary": { "get": { "summary": "Every country, procedure, notice step, case status and sector, with its label in plain English", "operationId": "vocabulary", "description": "Plans: Developer, Professional, Intel. Docs: https://insolvencyapi.com/documentation/vocabulary", "parameters": [], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Vocabulary" }, "meta": { "type": "object" } } }, "example": { "data": { "countries": [ { "code": "gb", "label": "United Kingdom", "held_as": "cases", "notices": true }, { "code": "fr", "label": "France", "held_as": "cases", "notices": true }, { "code": "at", "label": "Austria", "held_as": "cases", "notices": false } ], "procedures": [ { "code": "compulsory_liquidation", "label": "Compulsory liquidation (winding up by the court)" }, { "code": "creditors_voluntary_liquidation", "label": "Creditors' voluntary liquidation" }, { "code": "members_voluntary_liquidation", "label": "Members' voluntary liquidation" } ], "notice_steps": [ { "code": "petition_filed", "label": "Winding-up petition filed" }, { "code": "petition_served", "label": "Winding-up petition served" }, { "code": "petition_dismissed", "label": "Winding-up petition dismissed" } ], "case_statuses": [ { "code": "petition", "label": "A petition is pending" }, { "code": "open", "label": "Proceedings are open" }, { "code": "closing", "label": "Final steps under way" } ], "sectors": [ { "code": "A", "label": "Agriculture, forestry and fishing" }, { "code": "B", "label": "Mining and quarrying" }, { "code": "C", "label": "Manufacturing" } ], "drivers": [ { "code": "directors_resolution", "label": "The directors and shareholders decided to wind up (creditors' voluntary liquidation)" }, { "code": "tax_authority_petition", "label": "Wound up by the court on a petition from the tax authority" }, { "code": "public_interest_petition", "label": "Wound up by the court on a public interest petition from the government" } ] }, "meta": [] } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/usage": { "get": { "summary": "Your plan, the calls you have used and when they reset. Never counted", "operationId": "usage", "description": "Plans: Developer, Professional, Intel. Docs: https://insolvencyapi.com/documentation/usage", "parameters": [], "responses": { "200": { "description": "OK", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/Usage" }, "meta": { "type": "object" } } }, "example": { "data": { "key": { "prefix": "ik_live_4f9c" }, "plan": "intel", "plan_name": "Intel", "calls": { "today": 0, "this_month": 2 }, "limits": { "per_minute": 300, "per_day": null, "per_month": 100000, "limit_max": 100 }, "resets": { "day": "2026-11-01T00:00:00Z", "month": "2026-11-01T00:00:00Z" }, "reads_from": null, "reads_to": null, "paid_fields": true, "includes": null, "held_back": null, "countries": [ "gb", "fr", "at", "cz", "ee", "fi", "hr", "ie", "lv", "no", "pt", "ro", "sk", "es", "se", "pl", "us", "lt", "de", "ch", "ua", "si", "kr" ] }, "meta": [] } } } }, "401": { "description": "No key, or a key that is not active", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "The endpoint or field needs another plan", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Over the plan's limit a minute, or its quota a day or month: wait for Retry-After", "headers": { "X-RateLimit-Limit": { "description": "Requests allowed a minute on your plan", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "When the minute resets, Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "default": { "description": "An error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } } }