{
  "url": "https://getsonar.report/guides/companies-house-api",
  "markdown": "https://getsonar.report/guides/companies-house-api.md",
  "title": "Companies House API: free key, rate limit and endpoints — SONAR",
  "description": "The Companies House API is free: register, create an API key and send it as the basic auth username. Limit: 600 requests per 5 minutes. Endpoints and bulk data.",
  "language": "en",
  "dateModified": "2026-11-20",
  "summary": "The Companies House Public Data API at api.company-information.service.gov.uk is free: you register a user account on the Companies House Developer Hub, create an application and an API key, and send the key as the username of HTTP basic authentication with an empty password. Each application can make up to 600 requests in a 5-minute period; above that every request gets a 429 Too Many Requests until the window resets, and Companies House asks you to contact it for a higher limit. The API returns live JSON for the company profile, officers, persons with significant control (PSCs), filing history, charges, insolvency and search, while filed documents come from the separate Document API, real-time changes from the streaming API, and whole-register copies from free bulk downloads.",
  "keyFacts": [],
  "headings": [
    "Main Companies House Public Data API endpoints",
    "Other Companies House data services for developers",
    "How to check it manually",
    "What it tells you",
    "What it doesn’t tell you",
    "How SONAR automates it",
    "Frequently asked questions",
    "Official sources",
    "Related guides",
    "Run these checks on a company you’re about to sign"
  ],
  "tables": [
    {
      "title": "Main Companies House Public Data API endpoints",
      "columns": [
        "Endpoint (GET)",
        "What it returns"
      ],
      "rows": [
        [
          "/search/companies?q=",
          "Companies matching a search term, paged with items_per_page and start_index"
        ],
        [
          "/advanced-search/companies",
          "An advanced company search; /search/officers, /search/disqualified-officers and /dissolved-search/companies search other indexes"
        ],
        [
          "/company/{company_number}",
          "The company profile: name, number, type, status, date of creation, registered office, SIC codes, accounts and confirmation statement dates"
        ],
        [
          "/company/{company_number}/officers",
          "The list of the company’s officers, such as directors and secretaries"
        ],
        [
          "/officers/{officer_id}/appointments",
          "Every appointment held by one officer, across companies"
        ],
        [
          "/company/{company_number}/persons-with-significant-control",
          "The persons with significant control (individuals, corporate entities and legal persons); PSC statements are under /persons-with-significant-control-statements"
        ],
        [
          "/company/{company_number}/filing-history",
          "The filings made by the company, with a link to each document’s metadata in the Document API where one exists"
        ],
        [
          "/company/{company_number}/charges",
          "The charges (mortgages) registered against the company"
        ],
        [
          "/company/{company_number}/insolvency",
          "The company’s insolvency cases"
        ],
        [
          "/disqualified-officers/natural/{officer_id}",
          "The disqualifications of a disqualified director (a corporate version also exists)"
        ]
      ]
    },
    {
      "title": "Other Companies House data services for developers",
      "columns": [
        "Service",
        "Host or location",
        "What it gives you"
      ],
      "rows": [
        [
          "Document API",
          "document-api.company-information.service.gov.uk",
          "A filed document’s metadata (/document/{document_id}) and the document itself (/document/{document_id}/content)"
        ],
        [
          "Streaming API",
          "stream.companieshouse.gov.uk",
          "Real-time changes pushed over a long-running connection: companies, filings, officers, PSCs, PSC statements, charges, insolvency cases, disqualified officers and exemptions; at most 2 concurrent connections per account"
        ],
        [
          "Free Company Data Product",
          "download.companieshouse.gov.uk",
          "A monthly CSV snapshot of basic data on live companies, published within 5 working days of month end"
        ],
        [
          "PSC snapshot",
          "download.companieshouse.gov.uk",
          "The full list of PSCs as JSON files, refreshed every morning before 10am GMT"
        ],
        [
          "Accounts data product",
          "download.companieshouse.gov.uk",
          "Electronically filed accounts in XBRL and inline XBRL, as daily and monthly ZIP files"
        ],
        [
          "Sandbox",
          "api-sandbox.company-information.service.gov.uk",
          "A test environment for filing and OAuth integrations; the streaming and document APIs do not run there"
        ]
      ]
    }
  ],
  "faq": [
    {
      "question": "Is the Companies House API free?",
      "answer": "Yes. Companies House makes the public data it holds on companies available free of charge, including through its API. You need a free Companies House user account and an API key, and the bulk company data, PSC snapshot and accounts data products are free downloads too."
    },
    {
      "question": "What is the Companies House API rate limit?",
      "answer": "Up to 600 requests within a 5-minute period per application. If you go over, each further request in that window gets a 429 Too Many Requests status code, and the limit resets to 600 at the end of the period. If your application needs more, contact Companies House; applications that regularly exceed or try to bypass the limit can be banned without notice."
    },
    {
      "question": "How do I get a Companies House API key?",
      "answer": "Register or sign in on the Developer Hub at developer.company-information.service.gov.uk, create an application (live or sandbox), then select Create new key and choose the client type API key. Send the key as the username of HTTP basic authentication and leave the password blank."
    },
    {
      "question": "Can I get officers, PSCs and documents from the Companies House API?",
      "answer": "Officers and persons with significant control, yes: GET /company/{company_number}/officers and /company/{company_number}/persons-with-significant-control. Documents come from the separate Document API at document-api.company-information.service.gov.uk: the filing history gives each document’s metadata link, and /document/{document_id}/content fetches the file."
    },
    {
      "question": "Does the Companies House API include sanctions or PEP screening?",
      "answer": "No. It returns what is on the UK public register, such as companies, officers, PSCs, filings, charges and insolvency. To check the company and its people against sanctions lists, PEP data and adverse media, you need a separate screening step or a KYB service."
    }
  ],
  "sources": [
    {
      "title": "Companies House Developer Hub: API overview",
      "url": "https://developer.company-information.service.gov.uk/"
    },
    {
      "title": "Companies House Developer Hub: get started",
      "url": "https://developer.company-information.service.gov.uk/get-started"
    },
    {
      "title": "Companies House Developer Hub: how to create an application",
      "url": "https://developer.company-information.service.gov.uk/how-to-create-an-application"
    },
    {
      "title": "Companies House Developer Hub: API authentication",
      "url": "https://developer.company-information.service.gov.uk/authentication"
    },
    {
      "title": "Companies House Developer Hub: developer guidelines (rate limits, key security)",
      "url": "https://developer.company-information.service.gov.uk/developer-guidelines"
    },
    {
      "title": "Companies House Developer Hub: API testing and the sandbox",
      "url": "https://developer.company-information.service.gov.uk/api-testing"
    },
    {
      "title": "Companies House API: rate limiting",
      "url": "https://developer-specs.company-information.service.gov.uk/guides/rateLimiting"
    },
    {
      "title": "Companies House Public Data API reference",
      "url": "https://developer-specs.company-information.service.gov.uk/companies-house-public-data-api/reference"
    },
    {
      "title": "Companies House Document API reference",
      "url": "https://developer-specs.company-information.service.gov.uk/document-api/reference"
    },
    {
      "title": "Companies House streaming API: getting started",
      "url": "https://developer-specs.company-information.service.gov.uk/streaming-api/guides/overview"
    },
    {
      "title": "Companies House: Streaming API authentication (stream.companieshouse.gov.uk)",
      "url": "https://developer-specs.company-information.service.gov.uk/streaming-api/guides/authentication"
    },
    {
      "title": "Companies House streaming API reference",
      "url": "https://developer-specs.company-information.service.gov.uk/streaming-api/reference"
    },
    {
      "title": "GOV.UK: Companies House data products",
      "url": "https://www.gov.uk/guidance/companies-house-data-products"
    },
    {
      "title": "GOV.UK: searching the Companies House register",
      "url": "https://www.gov.uk/guidance/searching-the-companies-house-register"
    },
    {
      "title": "Companies House: Free Company Data Product",
      "url": "https://download.companieshouse.gov.uk/en_output.html"
    },
    {
      "title": "Companies House: PSC snapshot",
      "url": "https://download.companieshouse.gov.uk/en_pscdata.html"
    }
  ]
}