API reference

Company record #

The base record everything else hangs off: legal name, status, incorporation and cessation dates, company type, jurisdiction, SIC codes, the geocoded registered office, and the accounts and confirmation-statement calendar. Pass ?include= to attach officers, ownership, financials, filings, charges or the business profile in the same round trip.

Parameters

Response fields

Example

https://api.companytrack.com/v1/company?key=YOUR_API_KEY&company_number=00000042&include=financials,officers

{
  "status": "success",
  "credits_used": 4,
  "data": {
    "company_id": "UK-00000042",
    "company_number": "00000042",
    "company_name": "NORTHGATE ANALYTICS LTD",
    "company_status": "active",
    "company_type": "ltd",
    "date_of_creation": "2016-05-11",
    "date_of_cessation": null,
    "sic_codes": ["62012"],
    "jurisdiction": "england-wales",
    "region": "South West",
    "registered_office_address": {
      "address_string": "6 Northgate Street, Bristol, BS1 2AW",
      "lat": 51.4545,
      "lon": -2.5879
    },
    "accounts_summary": {
      "last_accounts_made_up_to": "2025-03-31",
      "last_accounts_type": "full",
      "next_due": "2026-12-31",
      "overdue": false
    },
    "company_size": { "category": "small", "num_employees": 42 },
    "has_charges": true,
    "has_insolvency_history": false,
    "certifications": []
  }
}

Notes

• company_size is an estimate against the current Companies Act thresholds, applying the meets-two-of-three rule to the latest filed accounts. It is null when fewer than two of the three criteria are disclosed — it is never guessed.
• Company 00000042 (and 00000041, 00000043) are fictional fixtures served free to every key, so every example on this page runs without spending a credit.

Filing history #

Accounts, confirmation statements, officer changes, charge registrations, share allotments and mortgage filings, each with a link to the source document on the Companies House service. This is how you detect material change without re-fetching the whole record: diff the newest filing date against the one you stored.

Parameters

Response fields

Example

https://api.companytrack.com/v1/company-filings?key=YOUR_API_KEY&company_number=00000042&category=accounts&limit=5

{
  "status": "success",
  "credits_used": 1,
  "data": {
    "company_number": "00000042",
    "filings": [
      {
        "category": "accounts",
        "type": "AA",
        "description": "accounts-with-accounts-type-full",
        "description_text": "Full accounts made up to 2025-03-31",
        "date": "2025-09-18",
        "made_up_to": "2025-03-31",
        "pages": 24,
        "document_available": true,
        "document_url": "https://find-and-update.company-information.service.gov.uk/company/00000042/filing-history/SANDBOX0001/document?format=pdf"
      }
    ],
    "next_cursor": null
  }
}

Notes

• description is the stable identifier; description_text is a convenience rendering whose wording may be refined over time. Key your logic off the former.

Accounts & ratios #

Companies House publishes accounts as iXBRL documents in three different disclosure regimes. This endpoint normalises all three into one response: turnover, gross profit, operating profit, EBITDA, balance-sheet totals, cash and headcount, plus a ratio block and growth rates, each tagged with the accounting period and the accounts type it came from.

Parameters

Response fields

Example

https://api.companytrack.com/v1/financials?key=YOUR_API_KEY&company_number=00000042&period=latest

{
  "status": "success",
  "credits_used": 2,
  "data": {
    "period_end": "2025-03-31",
    "accounts_type": "full",
    "currency": "GBP",
    "turnover": 4120000,
    "gross_profit": 2884000,
    "op_profit_loss": 412500,
    "ebitda": 596300,
    "total_assets": 3204800,
    "net_curr_assets": 1442900,
    "cash_eq": 1880400,
    "shareholder_funds": 2108300,
    "num_employees": 42,
    "ratios": {
      "gross_margin": 0.7,
      "operating_margin": 0.1,
      "current_ratio": 2.31,
      "gearing": 0.18
    },
    "growth": {
      "turnover_cagr_1y": 0.312,
      "turnover_cagr_3y": 0.268
    }
  }
}

Notes

• A figure that was not disclosed is null, never zero. A micro-entity with no P&L requirement returns a null turnover and a real balance sheet — treating that null as a zero is the single most common way to get UK accounts analysis wrong.
• A company that has never filed accounts returns status "no_data" and costs nothing.

Officers #

Every appointment on the register for one company, with role, appointment and resignation dates, nationality, occupation and month-precision date of birth. Each officer carries a person_id that resolves the same human across companies, so you can pivot from a director here straight into their other directorships.

Parameters

Response fields

Example

https://api.companytrack.com/v1/officers?key=YOUR_API_KEY&company_number=00000042

{
  "status": "success",
  "credits_used": 1,
  "data": {
    "company_number": "00000042",
    "officers": [
      {
        "person_id": "900000123",
        "name": "Priya Raman",
        "officer_role": "director",
        "appointed_on": "2016-05-11",
        "resigned_on": null,
        "date_of_birth": { "month": 4, "year": 1982 },
        "nationality": "British",
        "occupation": "Company Director"
      }
    ],
    "total_officers": 3
  }
}

Ownership & control #

Two things the register keeps in different places, returned together: the PSC statements filed under the control regime, and the actual shareholdings reconstructed from filed share allotments and confirmation statements. Corporate PSCs carry the company ID of the parent, so you can walk straight up the chain with /group-structure.

Parameters

Response fields

Example

https://api.companytrack.com/v1/ownership?key=YOUR_API_KEY&company_number=00000042

{
  "status": "success",
  "credits_used": 2,
  "data": {
    "controls": [
      {
        "name": "NORTHGATE GROUP HOLDINGS LTD",
        "kind": "corporate-entity-person-with-significant-control",
        "natures_of_control": ["ownership-of-shares-75-to-100-percent"],
        "parent_company_id": "UK-00000041",
        "ceased_on": null
      }
    ],
    "shareholders": [
      { "name": "NORTHGATE GROUP HOLDINGS LTD", "shares_perc": 82.5, "is_company": true },
      { "name": "Priya Raman", "shares_perc": 17.5, "is_company": false }
    ],
    "total_shareholders": 2,
    "psc_exemption": null
  }
}

Notes

• PSC statements and shareholdings answer different questions and can legitimately disagree: control is not the same as ownership. Both are returned so you can decide which one your use case needs.

Group structure #

Walks the corporate chain in either direction from one company, de-duplicated across the register, and returns it flat or nested. Ask for ancestors to find the ultimate parent behind a trading subsidiary; ask for descendants to enumerate everything a holding company sits on top of.

Parameters

Response fields

Example

https://api.companytrack.com/v1/group-structure?key=YOUR_API_KEY&company_number=00000042&direction=ancestors

{
  "status": "success",
  "credits_used": 2,
  "data": {
    "company_number": "00000042",
    "ancestors": [
      {
        "company_id": "UK-00000041",
        "company_name": "NORTHGATE GROUP HOLDINGS LTD",
        "level": 1,
        "basis": "ownership-of-shares-75-to-100-percent"
      }
    ],
    "ultimate_parent": {
      "company_id": "UK-00000041",
      "company_name": "NORTHGATE GROUP HOLDINGS LTD"
    }
  }
}

Notes

• Chains that leave the UK register (an overseas parent, say) stop there and say so, rather than reporting the last UK company as the ultimate owner.

Person & appointments #

The other side of /officers. Given a person_id, returns the individual and their full appointment history across the register — the endpoint behind "what else does this director run?" and behind any check for a disqualified or serially-dissolving director.

Parameters

Response fields

Example

https://api.companytrack.com/v1/person?key=YOUR_API_KEY&person_id=900000123

{
  "status": "success",
  "credits_used": 1,
  "data": {
    "person_id": "900000123",
    "name": "Priya Raman",
    "date_of_birth": { "month": 4, "year": 1982 },
    "appointments": [
      {
        "company_id": "UK-00000042",
        "company_name": "NORTHGATE ANALYTICS LTD",
        "company_status": "active",
        "officer_role": "director",
        "appointed_on": "2016-05-11",
        "resigned_on": null
      }
    ],
    "total_appointments": 3
  }
}

Notes

• Dates of birth are month-precision on the register, so two people sharing a name and birth month cannot always be separated. Matches are graded by confidence and only high-confidence resolutions are merged into one person_id.

Company search #

Two searches behind one endpoint. Give it a name or a number and it resolves that company across the active register. Give it a description and it matches on meaning across the business description, offerings and target customers — so "cold-chain logistics for pharma" finds a company whose own site says "temperature-controlled distribution for life sciences", with no shared keyword. Layer structured filters on top to screen by turnover, headcount, region or sector.

Parameters

Response fields

Example

https://api.companytrack.com/v1/search?key=YOUR_API_KEY&q=cold-chain%20logistics&turnover_min=1000000&sort=turnover_cagr_3y_desc&limit=20

{
  "status": "success",
  "credits_used": 1,
  "data": {
    "found": 342,
    "page": 1,
    "mode": "semantic",
    "name_match": false,
    "undisclosed_excluded": 1180,
    "results": [
      {
        "company_id": "UK-00000042",
        "company_number": "00000042",
        "company_name": "NORTHGATE ANALYTICS LTD",
        "match": "semantic",
        "short_desc": "Revenue forecasting platform for subscription businesses.",
        "org_kind": "product_vendor",
        "sector": "Finance Software",
        "locality": "Bristol",
        "region": "South West",
        "status": "active",
        "turnover": 4120000,
        "employees": 42,
        "incorporated_year": 2016,
        "websites": ["northgateanalytics.example"]
      }
    ]
  }
}

Notes

• Check name_match before trusting a lookup. A semantic search always returns its nearest neighbours, so an unrecognised name comes back as a page of similar-sounding companies rather than an empty result.
• Ranking a niche by turnover returns less than you expect: only about 218,000 active companies disclose one, against 2.6 million disclosing headcount. undisclosed_excluded tells you how much was dropped, and shareholder funds usually rank such a list better.
• Combining a text query with a financial sort ranks within the most relevant companies, not across the whole register — otherwise you would get the biggest companies loosely related to the query instead of the biggest relevant ones.

Business profile #

The layer a SIC code cannot give you. A verified domain is matched to the legal entity and the site is read into structured facets: a plain-English description, the offerings sold, the customer segments served, and the delivery model. It is what separates a careers-software vendor from a university that happens to mention careers.

Parameters

Response fields

Example

https://api.companytrack.com/v1/intelligence?key=YOUR_API_KEY&company_number=00000042

{
  "status": "success",
  "credits_used": 1,
  "data": {
    "company_name": "NORTHGATE ANALYTICS LTD",
    "domain": "northgateanalytics.example",
    "short_desc": "Revenue forecasting platform for subscription businesses.",
    "org_kind": "product_vendor",
    "sector": "Finance Software",
    "offerings": ["revenue forecasting", "churn analytics", "board reporting"],
    "customer_segments": ["smb", "enterprise"],
    "delivery": ["saas_platform", "api_data"],
    "market": ["b2b"]
  }
}

Notes

• Coverage is the 1.15 million active companies with a verified website. A company without one is still findable by name and still has a full registry record — it just has no business profile.
• A company with no verified website returns status "no_data" and costs nothing.

Charges #

Mortgages, debentures and fixed or floating charges as registered, with the persons entitled, the created and delivered dates, the satisfied status and the short particulars. The fastest read on whether a company has borrowed against its assets and who has first claim on them.

Parameters

Response fields

Example

https://api.companytrack.com/v1/charges?key=YOUR_API_KEY&company_number=00000042

{
  "status": "success",
  "credits_used": 1,
  "data": {
    "company_number": "00000042",
    "charges": [
      {
        "status": "outstanding",
        "created_on": "2023-11-02",
        "delivered_on": "2023-11-09",
        "satisfied_on": null,
        "persons_entitled": ["NORTHGATE BANK PLC"],
        "particulars": "Fixed and floating charge over all assets"
      }
    ],
    "total_outstanding": 1
  }
}

Property holdings #

Freehold and leasehold titles registered to the company, matched to the legal entity rather than to a similar name, with tenure, the address and the price paid where the Land Registry publishes it. Property is the asset base that never appears in a set of micro-entity accounts.

Parameters

Response fields

Example

https://api.companytrack.com/v1/properties?key=YOUR_API_KEY&company_number=00000042

{
  "status": "success",
  "credits_used": 1,
  "data": {
    "company_number": "00000042",
    "properties": [
      {
        "title_number": "BL123456",
        "address": "6 Northgate Street, Bristol, BS1 2AW",
        "tenure": "freehold",
        "price_paid": 1250000,
        "date_of_transfer": "2019-08-14"
      }
    ],
    "total_properties": 1
  }
}

Grant awards #

Innovate UK, research council and other public awards, matched to the company number rather than to a name that merely looks similar. 329,000 awards across 78,000 UK companies — a strong signal of R&D activity in businesses too small to file a meaningful P&L.

Parameters

Response fields

Example

https://api.companytrack.com/v1/grants?key=YOUR_API_KEY&company_number=00000042

{
  "status": "success",
  "credits_used": 1,
  "data": {
    "company_number": "00000042",
    "grants": [
      {
        "funder": "Innovate UK",
        "programme": "Smart Grants",
        "title": "Forecasting models for subscription revenue",
        "amount": 348000,
        "start_date": "2023-01-01",
        "end_date": "2024-06-30"
      }
    ],
    "total_awarded": 348000
  }
}

Notes

• A company with no matched award returns status "no_data" and costs nothing.

Fundraisings #

UK private companies do not announce their rounds, but they do have to file an SH01 when they allot shares. This endpoint reconstructs those allotments into fundraising events — amount raised, price per share, date and the resulting share capital — so you can see a raise from the register rather than waiting for a press release.

Parameters

Response fields

Example

https://api.companytrack.com/v1/fundraisings?key=YOUR_API_KEY&company_number=00000042

{
  "status": "success",
  "credits_used": 2,
  "data": {
    "company_number": "00000042",
    "fundraisings": [
      {
        "date": "2024-02-19",
        "amount_raised": 2400000,
        "price_per_share": 12.5,
        "share_class": "Preferred A",
        "shares_allotted": 192000
      }
    ],
    "total_raised": 2400000
  }
}

Notes

• These are reconstructions from filings, not announcements. An allotment with no consideration disclosed returns a null amount rather than an estimate.
• A company with no recorded allotments returns status "no_data" and costs nothing.

News #

Press coverage resolved against the legal entity, with the publication, date, URL and a short summary, plus topic tags so you can filter to funding, hiring or distress signals. Results are cached, so a repeat lookup of the same company is far cheaper than the first.

Parameters

Response fields

Example

https://api.companytrack.com/v1/news?key=YOUR_API_KEY&company_number=00000042

{
  "status": "success",
  "credits_used": 3,
  "data": {
    "company_number": "00000042",
    "items": [
      {
        "title": "Northgate Analytics raises £2.4m to expand forecasting platform",
        "url": "https://example.com/northgate-raise",
        "publisher": "Business Insider UK",
        "published_at": "2024-02-21",
        "summary": "Bristol-based Northgate Analytics has closed a £2.4m round…",
        "topics": ["funding"]
      }
    ]
  }
}

Notes

• A live lookup that finds nothing is charged, because the search ran either way. Every later "nothing found" for that company is answered from cache and is free.

Credit balance #

A free call that never consumes credits. Poll it to drive your own usage dashboard, or check it before firing a large batch so you fail fast rather than half way through.

Parameters

Response fields

Example

https://api.companytrack.com/v1/account/credits?key=YOUR_API_KEY

{
  "status": "success",
  "credits_used": 0,
  "data": {
    "plan": "growth",
    "credits_remaining": 46812,
    "credits_allowance": 50000,
    "period_end": "2026-09-01"
  }
}

Status codes #

Only a successful lookup is charged. Every other outcome — a bad parameter, an unknown company, an exhausted allowance, a server fault — costs nothing, so retrying a failed batch never compounds the bill.