How to get only acitve officers?

[da61]

Can anyone provide me with correct endpoint to get only active officers?

[voracityemail]

Do you mean “all the active officers Companies House knows about (for all companies)” or “all the active officers for a given company”?

The first - you can make a request to get access to the officers bulk data downloads (search on this forum for how). That is their recommended way (and indeed the only way I think).

For the second, as far as I know there isn’t one - although the Companies Search web site allows you to tick to only see these.

People have been asking for this for a while.

Active Officers Only

Hi there, how can I get only the active officers list? Currently, whether to use ‘register_type’ and ‘register_view’ or not, the result is all officers?

You can change the ordering however. I believe currently the default order is that the “active” officers come first. This doesn’t save you from parsing the results to see if there’s a resigned_on field, but it does mean you may not need to request them all (Companies House have a “paged” API so if there are a lot of results you won’t get them all at once).

Details per here:

Company Officers LIST Ordering of results changes

Hi, We were using order_by=resigned_on in order to get active directors FIRST on the CompanyOfficers LIST request: GET /company/{company_number}/officers?order_by=resigned_on&items_per_page=10 which would previously return active officers first (I’d have hoped there would be an active=true parameter to achieve this but we used what we had) It seems this now returns active directors LAST. This has been a breaking change for us, is it likely that this is going to be changed back or do we need …

Good luck.

[ebrian101]

Short answer: Query param ?filter=active.

Here’s a post I made last year that may be of help, though I can’t find an official source now that I search for it.

Filtering active directors in /company/{company_number}/officers endpoint

There is a recently introduced query parameter to the list officers endpoint which filters for only active officers. Add ?filter=active to your request and its not necessary to filter for register_type/register_view for this purpose. This returns officers of all officer_roles though, so you’ll have to filter it for officer_role=director on the receiving end. It just filters out any resigned officers. Hope that helps

[voracityemail]

Good spot - we had missed that this could be applied to the Company Officers list endpoint as well as the Officers Appointments.

It would be logical, but the documentation for the former hasn’t been updated to show the filter parameter - nor has the Swagger / OpenAPI spec for what that’s worth…

Thanks!