BETA This is a new service.

Request

GET https://api.companieshouse.gov.uk/company/{company_number}/filing-history

Query parameters

Parameter nameValueDescriptionAdditional
category string One or more comma-separated categories to filter by (inclusive). Optional.
company_number string The company number that the filing history is required for.
items_per_page integer The number of filing history items to return per page. Optional.
start_index integer The index into the entire result set that this result page starts. Optional.

Request headers

This method does not require specific header parameters.

Request body

This method does not take any request body parameters.

Authentication

Not required.

Response

Response headers

This method does not return specific response headers.

Response body

If successful, this method returns a filingHistoryList resource in the body.

Status codes

The following HTTP status codes may be returned, optionally with a response resource:

Status codeDescriptionResponse Resource
200 Filing history items resource returned filingHistoryList
404 Filing history not available for this company

CURL example

curl -uYOUR_APIKEY_FOLLOWED_BY_A_COLON: https://api.companieshouse.gov.uk/company/{company_number}/filing-history

Explore this API

company_number The company number that the filing history is required for.
category One or more comma-separated categories to filter by (inclusive).
items_per_page The number of filing history items to return per page.
start_index The index into the entire result set that this result page starts.

To explore this api, you must be signed in and have registered for at least one API key. Registration takes a few seconds, and allows you to explore the API from right here in the web page!

You can create an API key through Your Applications page.