Home/Documentation/Cases

Insolvency API cases

Every notice, as it is published

Notices from the UK and France, newest first: petitions, orders, appointments, calls for claims and closings.

Every planMCP tool: latest_notices

The call

Every published notice, newest first, in the countries that publish notices (UK and France).

GEThttps://api.insolvencyapi.com/v1/notices

Try it

Your keyGet a free key

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

country

step

procedure

published_from

published_to

limit

Calls the API from this browser with your key.

curl PHP Python JavaScriptCopy

Code, built from the form

The answer

Parameters

NameTypeNeededWhat it does

countrylistOptionalgb, fr or both.gbfr

steplistOptionalOne or more notice steps, see /v1/vocabulary.petition_filedpetition_servedpetition_dismissedwinding_up_orderresolution_to_wind_upliquidator_appointedliquidator_releasedadministrator_appointedadministration_orderreceiver_appointedcreditors_meetingnotice_to_creditorsnotice_to_membersdeemed_consentdecision_procedureintended_dividenddividendannual_meetingfinal_meetingpublic_examinationmoratorium_startedmoratorium_endedprohibited_namecross_borderopening_judgmentplan_adoptedconversionclosing_judgmentclaims_list_filedplan_changedplan_cancelledextensiondistribution_plan_filedreopenedopening_withdrawnappeal_decisionofficeholders_appointedother

procedurelistOptionalOne or more procedures.compulsory_liquidationcreditors_voluntary_liquidationmembers_voluntary_liquidationadministrationadministrative_receivershipreceivershipmoratoriumjudicial_liquidationjudicial_reorganisationsafeguardconciliationother

published_fromdateOptionalPublished on or after.

published_todateOptionalPublished on or before.

limitnumberOptionalResults a page: 25 if left out, up to 100 on paid plans and 25 on Developer.

pagenumberOptionalThe page, from 1.

cursortextOptionalThe next_cursor from the page before.

What comes back

A list in data, each item with these fields. Paging and counts are in meta; see Pagination.

FieldTypeWhat it holds

idtextThe notice id, nt_ followed by 8 characters.

case_idtextThe case it belongs to.

countrytextgb or fr.

steptextThe step it records, see /v1/vocabulary.

step_labeltextThe step in plain English.

proceduretextThe procedure it belongs to.

published_ondateThe day it was published.

event_ondate, or nullThe day the notice is about: the order, resolution, appointment or judgment.

companyobjectregister_number and name.

claims_deadlinedate, or nullA deadline for creditors set by this notice (paid plans).

hearingobject, or nullA hearing set by this notice (paid plans).

courttext, or nullThe court (paid plans).

court_case_reftext, or nullThe court's case number (paid plans).

detailsobject, or nullregistered_office, trading_as, previous_name, nature_of_business, legal_form, petitioner, appointed_by, meeting, practitioners (count and roles; never names), where published (paid plans).

An example answer

A real answer from this morning’s data, made by the call Try it opens on.

Example answerCopy

{
  "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
  }
}

Errors it can return

400bad_requestA value is wrong, such as a date in another format. The message says which.401unauthorizedThe key is missing, wrong or no longer valid.422unknown_parameterA parameter this endpoint does not take. The answer lists the ones it does.429rate_limitedToo many calls in one minute. Wait for the seconds in Retry-After.429quota_exceededYour calls for the day or month are used. The answer says when they reset.

Good to know

Every notice carries its case_id, so One case gives the whole story. Notices are held for the UK and France.