API Reference

Programmatic access to UK company data — 5.5M+ companies, officers, financials, and PSCs.

Authentication

All API requests must include an API key in the Authorization header:

curl -H "Authorization: Bearer atl_your_key" \
  https://finsburysuite.com/api/v1/companies?q=barclays

Generate API keys in your Settings → API Keys. Keys have a default rate limit of 60 requests/minute.

Quick start

Search companies

curl -H "Authorization: Bearer atl_your_key" \
  "https://finsburysuite.com/api/v1/companies?q=barclays&limit=5"

Get credit score

curl -H "Authorization: Bearer atl_your_key" \
  "https://finsburysuite.com/api/v1/companies/00000006/credit-score"

Use cases

Credit decisioning

Use /credit-score and /credit-limit to automate pre-qualification. Combine with /financials for a full picture of the company's financial health.

/companies/{number}/credit-score/companies/{number}/credit-limit/companies/{number}/financials

Supplier onboarding

Verify supplier identity, check for insolvency, and review key officers during KYC/KYB workflows.

/companies/{number}/companies/{number}/officers/companies/{number}/insolvency/companies/{number}/pscs

Portfolio monitoring

Periodically pull charges and financials for your existing customer portfolio to detect deteriorating credit quality.

/companies/{number}/charges/companies/{number}/financials/companies/{number}/credit-score

All endpoints

get/api/v1/companies

Search companies

Parameters

qrequiredCompany name or number

limit

offset

statusFilter by company status

categoryFilter by company category

get/api/v1/companies/{number}

Get a company by number

Parameters

numberrequired8-digit Companies House number

get/api/v1/companies/{number}/officers

List officers for a company

Parameters

numberrequired

get/api/v1/companies/{number}/financials

Get financial data for a company

Parameters

numberrequired

get/api/v1/companies/{number}/pscs

List persons with significant control

Parameters

numberrequired

get/api/v1/companies/{number}/credit-score

Get Finsbury Suite credit score for a company

Parameters

numberrequired8-digit Companies House number

get/api/v1/companies/{number}/credit-limit

Get indicative credit limit for a company

Parameters

numberrequired

get/api/v1/companies/{number}/charges

Get registered charge counts for a company

Parameters

numberrequired

get/api/v1/companies/{number}/insolvency

Get insolvency cases for a company

Parameters

numberrequired

get/api/v1/companies/{number}/summary

Get Finsbury Intelligence company summary

Parameters

numberrequired8-digit Companies House number

get/api/v1/officers/search

Search directors and officers

Parameters

qrequiredName (e.g. 'SMITH John')

limit

Response format

All successful responses follow this envelope:

{
  "data": [...],       // array or object
  "meta": {
    "total": 1234,     // total matching records
    "limit": 20,
    "offset": 0,
    "query": "barclays"
  }
}

Rate limits

Default: 60 requests per minute per API key. Exceeding this returns a 429 Too Many Requests.

Plan	Rate limit
Free	60 req/min
Professional	300 req/min
Teams	1,000 req/min
Business	5,000 req/min
Enterprise	Custom