Home/Documentation/Companies

Insolvency API companies

Check a list of companies

Up to 100 companies in one call, by register number or by name.

Every planMCP tool: check_companies

The call

Check up to 100 companies in one call, by register number or by name; each company counts as one call.

POSThttps://api.insolvencyapi.com/v1/companies/check

Try it

Your keyGet a free key

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

Calls the API from this browser with your key.

curl PHP Python JavaScriptCopy

Code, built from the form

The answer

Parameters

This endpoint takes no parameters.

What comes back

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

FieldTypeWhat it holds

indexnumberThe company's position in your list.

matchedtrue or falseTrue when a company was found.

matchtextregister_number, name_and_postcode, name, ambiguous or none.

candidateslistUp to 3 possible companies when the match is ambiguous.

countries_checkednumberFor a name with no country: how many countries were checked.

companyobject, or nullcountry, register_number and name.

in_insolvencytrue or falseTrue when any case is active.

caseslistThe company's cases.

errortextWhy this one item could not be checked, when it could not.

An example answer

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

Example answerCopy

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

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

Each company counts as one call. A name with no country is checked in every country; a UK name with its postcode tells two companies of the same name apart.