Director name not pulling for some API requests

My company currently uses the following APIs:

When calling all three of these for company reg number 12319963 I do not get any director names returned at all. Requests below:

Request

GET /search/companies?q=12319963 HTTP/1.1
Host: api.companieshouse.gov.ukundefined

Response status

200 success

Response body

{
“page_number”: 1,
“start_index”: 0,
“items”: [
{
“description_identifier”: [
“incorporated-on”
],
“kind”: “searchresults#company”,
“title”: “ABSOLUTE OUTSOURCING LIMITED”,
“description”: “12319963 - Incorporated on 18 November 2019”,
“address_snippet”: “Fernhills House Foerster Chambers, Todd Street, Greater Manchester, United Kingdom, BL9 5BJ”,
“company_type”: “ltd”,
“address”: {
“premises”: “Fernhills House Foerster Chambers”,
“locality”: “Greater Manchester”,
“postal_code”: “BL9 5BJ”,
“country”: “United Kingdom”,
“address_line_1”: “Todd Street”
},
“company_status”: “active”,
“links”: {
“self”: “/company/12319963”
},
“date_of_creation”: “2019-11-18”,
“company_number”: “12319963”
}
],
“items_per_page”: 20,
“total_results”: 1,
“kind”: “search#companies”
}

Request

GET /search?q=12319963 HTTP/1.1
Host: api.companieshouse.gov.ukundefined

Response status

200 success

Response body

{
“items”: [
{
“links”: {
“self”: “/company/12319963”
},
“kind”: “searchresults#company”,
“date_of_creation”: “2019-11-18”,
“description”: “12319963 - Incorporated on 18 November 2019”,
“address”: {
“premises”: “Fernhills House Foerster Chambers”,
“address_line_1”: “Todd Street”,
“locality”: “Greater Manchester”,
“postal_code”: “BL9 5BJ”,
“country”: “United Kingdom”
},
“company_status”: “active”,
“address_snippet”: “Fernhills House Foerster Chambers, Todd Street, Greater Manchester, United Kingdom, BL9 5BJ”,
“company_number”: “12319963”,
“title”: “ABSOLUTE OUTSOURCING LIMITED”,
“description_identifier”: [
“incorporated-on”
],
“company_type”: “ltd”
}
],
“items_per_page”: 20,
“kind”: “search#all”,
“total_results”: 1,
“start_index”: 0,
“page_number”: 1
}

Request

GET /search/officers?q=12319963 HTTP/1.1
Host: api.companieshouse.gov.uk

Response status

200 success

Response body

{
“items”: [],
“start_index”: 0,
“items_per_page”: 20,
“page_number”: 1,
“total_results”: 0,
“kind”: “search#officers”
}

Is it possible to get this looked at?

You’re using the “search” endpoints and these are doing what I understand they should. I don’t think you can search officers by company number using this endpoint. If you want to find officers for a given company you need to go directly to the Company Officers endpoint. I just tried this:

https://api.companieshouse.gov.uk/company/12319963/officers

…and it returned the 3 officers shown in e.g. CH Beta.

The default search will return results from “search companies” and “search officers” - search companies will return the company profile resource. This doesn’t list directors, as you found.

The officer search appears to match on name (or part of it) or parts of address (e.g. postcode).

Ideally Companies House would supply more extensive documentation for this but there is this forum…

To test what you can get you can also try CH Beta. Searching this forum will give you more about what you can do / get via search.

1 Like