For the authenticated firm, return a list of the Business Units, Services, and Staff (including roles) that have been set up for that firm. For all details see https://developer.firmcheck.com/reference/getfirm#/

The Firmcheck API is officially version 1 and out of beta. Big thank you to our beta testers that were giving us feedback with our early versions of the API 😃

We have 3 API endpoints available:

• Get client list
• Get client
• Create client (Individual, Sole traders, Companies House companies)

And more endpoints will be added over time! Please refer to the API reference documentation for more details on these API requests.

For those that were connected to our API during beta, due to some breaking changes there are some actions required as we move to Version 1.0 :

• Generate new API keys – we've had to make a breaking change to how we hash the API keys, and unfortunately this will mean you need to generate a new key to continue getting access.
• Changed name from contact to entity in the Client endpoints when referring to the client type (organisation, individual or sole trader). Based on feedback on the term contact, we have changed this to entity – and that will mean any references you have to this will need to be updated.

• We've added the parameter sinceModifiedAtto the clientList request, this will filter only clients that have had changes since the date you specify.
• You can now create clients using a UK Companies House company number. When creating the client, Firmcheck will also pull the directors and PSCs and include them with that client as related parties. Please see https://developer.firmcheck.com/reference/createclient#/ for more details.
• A bug where the clientList was including discarded and archived clients has been fixed, the request now only returns clients that have the state PROSPECT and EXISTING.