# Is there an Officers API available? **URL:** \ **Category:** Uncategorized\ **Created:** [June 26, 2015, 10:36am UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122 "2015-06-26T10:36:05Z")\ **Posts on this page:** 20\ **Page:** 1
**Author:** ![hywel\_bromby](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/h/35a633/32.png) [@hywel\_bromby](http://forum.companieshouse.gov.uk/u/hywel_bromby)\ **Post date:** [June 26, 2015, 10:36am UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/1 "2015-06-26T10:36:05Z")
Hi There is a link on each officer in the filing history to show “appointments” is there an API equivalent? Cheers Hywel ---
**Author:** ![mfairhurst](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/m/bbce88/32.png) [@mfairhurst](http://forum.companieshouse.gov.uk/u/mfairhurst)\ **Post date:** [June 26, 2015, 2:16pm UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/2 "2015-06-26T14:16:48Z")
We are actively working on the personal appointments data set and the official documentation and is subject to change but if you want to take a look, here are some details. Query the officer end point: [https://api.companieshouse.gov.uk/company/](https://api.companieshouse.gov.uk/company/)_company\_number_/officers Each officers returned will contain a link to their appointments, eg: links":{“officer”:{“appointments”:"/officers/zWX\_7lQPOybWn4dxDOuarrw18YQ/appointments" If you use this link it will return the appointments for that officer, eg: [https://api.companieshouse.gov.uk/officers/zWX\_7lQPOybWn4dxDOuarrw18YQ/appointments](https://api.companieshouse.gov.uk/officers/zWX_7lQPOybWn4dxDOuarrw18YQ/appointments) ---
**Author:** ![spryt](http://forum.companieshouse.gov.uk/user_avatar/forum.companieshouse.gov.uk/spryt/32/1120_2.png) [@spryt](http://forum.companieshouse.gov.uk/u/spryt)\ **Post date:** [July 2, 2015, 9:34am UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/3 "2015-07-02T09:34:37Z")
I have a question about the endpoint that returns a list of all the officers past and present for a company - [https://developer.companieshouse.gov.uk/api/docs/company/company\_number/officers/officerList.html](https://developer.companieshouse.gov.uk/api/docs/company/company_number/officers/officerList.html) For each officer’s date of birth it currently only returns the month and year. How do we get the day? Thanks ---
**Author:** ![mfairhurst](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/m/bbce88/32.png) [@mfairhurst](http://forum.companieshouse.gov.uk/u/mfairhurst)\ **Post date:** [July 2, 2015, 9:56am UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/4 "2015-07-02T09:56:14Z")
Due to customer feedback and a upcoming legislative change we are now suppressing the day of the date of birth. Please see the attached forum post > [@Date of Birth Suppression](http://forum.aws.chdev.org/t/date-of-birth-suppression/118): > > Change: To suppress the day element on officer dates of birth Proposed Implementation Date: 29/06/2015 Resources Affected: Company Profile [https://api.companieshouse.gov.uk/company/{company\_number}](https://api.companieshouse.gov.uk/company/%7Bcompany_number%7D) The officer\_summary.officers[].date\_of\_birth will be replaced with "date\_of\_birth": { "month": 2, "year": 1945 } Officer List [https://api.companieshouse.gov.uk/company/{company\_number}/officers](https://api.companieshouse.gov.uk/company/%7Bcompany_number%7D/officers) The items[].date\_of\_birth will be replaced with "date\_of\_birth": { "mo… ---
**Author:** ![spryt](http://forum.companieshouse.gov.uk/user_avatar/forum.companieshouse.gov.uk/spryt/32/1120_2.png) [@spryt](http://forum.companieshouse.gov.uk/u/spryt)\ **Post date:** [July 2, 2015, 10:16am UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/5 "2015-07-02T10:16:04Z")
Ok. Thanks. It is a shame. Is there anyway of getting this data through a special license? As we are developing software for financial institutions that require the full date of birth for ID verification. ---
**Author:** ![mfairhurst](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/m/bbce88/32.png) [@mfairhurst](http://forum.companieshouse.gov.uk/u/mfairhurst)\ **Post date:** [July 2, 2015, 2:43pm UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/6 "2015-07-02T14:43:18Z")
The data can be made available but to Credit Reference Agencies and specified public authorities who have to apply to have access. ---
**Author:** ![andreas\_philippi](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/a/8797f3/32.png) [@andreas\_philippi](http://forum.companieshouse.gov.uk/u/andreas_philippi)\ **Post date:** [August 13, 2015, 11:34am UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/7 "2015-08-13T11:34:18Z")
Hi, Will there be a API endpoint where you can search for a officer by name? Something similar to the company search function: GET [https://api.companieshouse.gov.uk/search/companies](https://api.companieshouse.gov.uk/search/companies) but for officers … If so, when do you expect this to be available? Thanks, Andreas ---
**Author:** ![mfairhurst](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/m/bbce88/32.png) [@mfairhurst](http://forum.companieshouse.gov.uk/u/mfairhurst)\ **Post date:** [August 13, 2015, 1:23pm UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/8 "2015-08-13T13:23:26Z")
The plan is to release Officer search functionality and are planning to release in September. We will post on the forum exact release details nearer the time. > [@Search for officers?](http://forum.aws.chdev.org/t/search-for-officers/176): > > Is it possible to search for officers? I haven’t been able to find it. Is this something that is in the pipeline? If so, what’s the expected time frame? ---
**Author:** ![sls](http://forum.companieshouse.gov.uk/user_avatar/forum.companieshouse.gov.uk/sls/32/111_2.png) [@sls](http://forum.companieshouse.gov.uk/u/sls)\ **Post date:** [August 21, 2015, 8:04am UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/9 "2015-08-21T08:04:45Z")
Is there already or going to be functionality to query by Nationality, please? ---
**Author:** ![mfairhurst](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/m/bbce88/32.png) [@mfairhurst](http://forum.companieshouse.gov.uk/u/mfairhurst)\ **Post date:** [August 24, 2015, 10:13am UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/10 "2015-08-24T10:13:14Z")
The initial release in September will be to search by name and address. Searching by nationality is not in our current thinking but if its determined there is user need then we would look to address. What requirement are you looking to satisfy by searching by nationality? Thanks, Mark. ---
**Author:** ![sls](http://forum.companieshouse.gov.uk/user_avatar/forum.companieshouse.gov.uk/sls/32/111_2.png) [@sls](http://forum.companieshouse.gov.uk/u/sls)\ **Post date:** [August 25, 2015, 8:22am UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/11 "2015-08-25T08:22:17Z")
Thanks for the reply Mark - I’m looking to use the Nationality (starting with USA or American) to be able to help them easily fill out certain US tax forms. There could be some use for FATCA purposes within FS industry. The database won’t capture 100% of relevant people/companies as some may be dual nationals and only list UK on companies house but it would be a great starting point. Thanks again, Sharon ---
**Author:** ![manoj\_ranaweera](http://forum.companieshouse.gov.uk/user_avatar/forum.companieshouse.gov.uk/manoj_ranaweera/32/110_2.png) [@manoj\_ranaweera](http://forum.companieshouse.gov.uk/u/manoj_ranaweera)\ **Post date:** [August 25, 2015, 9:55am UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/12 "2015-08-25T09:55:35Z")
Hi Mark, Are there any plans to release known email addresses or pictures of officers? I know this might be seen as a breach of privacy, but some the details already exist in the public domain, especially on companies’ own websites. Perhaps a permission driven approach might be the way forward, i.e. individual officers giving permission to release some of their details. ---
**Author:** ![jordan\_hall](http://forum.companieshouse.gov.uk/user_avatar/forum.companieshouse.gov.uk/jordan_hall/32/113_2.png) [@jordan\_hall](http://forum.companieshouse.gov.uk/u/jordan_hall)\ **Post date:** [August 25, 2015, 1:13pm UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/13 "2015-08-25T13:13:26Z")
I would not be comfortable with this myself. Currently, you do not provide any images of individuals to companies house. This mean one of the following would have to take place. 1. Whenever you annual turns you are requested to upload an image of you. 2. Companies House decides to use social engineering to scan the internet for a picture of the officer that may be incorrect. I know many businesses that don’t contain images of the directors. ---
**Author:** ![manoj\_ranaweera](http://forum.companieshouse.gov.uk/user_avatar/forum.companieshouse.gov.uk/manoj_ranaweera/32/110_2.png) [@manoj\_ranaweera](http://forum.companieshouse.gov.uk/u/manoj_ranaweera)\ **Post date:** [August 25, 2015, 1:53pm UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/14 "2015-08-25T13:53:14Z")
Perhaps images are bit more over ambitious on our part. We can in fact pull in the images if email addresses are known. ---
**Author:** ![jordan\_hall](http://forum.companieshouse.gov.uk/user_avatar/forum.companieshouse.gov.uk/jordan_hall/32/113_2.png) [@jordan\_hall](http://forum.companieshouse.gov.uk/u/jordan_hall)\ **Post date:** [August 25, 2015, 2:06pm UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/15 "2015-08-25T14:06:18Z")
> [@manoj\_ranaweera](#): > > Perhaps images are bit more over ambitious on our part. We can in fact pull in the images if email addresses are known. How would you pull the images if email address is known. It would also require all email address to have images. and a change to the way companies house filling works and end the paper base filling ---
**Author:** ![manoj\_ranaweera](http://forum.companieshouse.gov.uk/user_avatar/forum.companieshouse.gov.uk/manoj_ranaweera/32/110_2.png) [@manoj\_ranaweera](http://forum.companieshouse.gov.uk/u/manoj_ranaweera)\ **Post date:** [August 25, 2015, 3:50pm UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/16 "2015-08-25T15:50:42Z")
We won’t get it 100% correct, but images could come from many sources including our own CRM. Feel free to play with [http://app.livestax.com/unifiedvu/welcome/customer-intelligence](http://app.livestax.com/unifiedvu/welcome/customer-intelligence) - next iteration will connect it to CRM systems. ---
**Author:** ![ash](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/a/f19dbf/32.png) [@ash](http://forum.companieshouse.gov.uk/u/ash)\ **Post date:** [August 25, 2015, 4:26pm UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/17 "2015-08-25T16:26:14Z")
Companies House don’t have this information so they couldn’t provide it through the API if they wanted to! ---
**Author:** ![mfairhurst](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/m/bbce88/32.png) [@mfairhurst](http://forum.companieshouse.gov.uk/u/mfairhurst)\ **Post date:** [August 26, 2015, 8:41am UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/18 "2015-08-26T08:41:35Z")
As Ash has stated Companies House do not collect images or email addresses of directors so we cannot provide. ---
**Author:** ![manoj\_ranaweera](http://forum.companieshouse.gov.uk/user_avatar/forum.companieshouse.gov.uk/manoj_ranaweera/32/110_2.png) [@manoj\_ranaweera](http://forum.companieshouse.gov.uk/u/manoj_ranaweera)\ **Post date:** [August 27, 2015, 7:32am UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/19 "2015-08-27T07:32:00Z")
Thanks Mark. We will try to think of something at our end. ---
**Author:** ![frank1](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/f/a87d85/32.png) [@frank1](http://forum.companieshouse.gov.uk/u/frank1)\ **Post date:** [October 13, 2015, 1:31pm UTC](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122/20 "2015-10-13T13:31:26Z")
Hi Mark, I understand from one of your previous posts that an API endpoint to search by officer name was foreseen for September. Is it already implemented and I missed it, or are you working on it? Many thanks, Frank [Next page](http://forum.companieshouse.gov.uk/t/is-there-an-officers-api-available/122.md?page=2)