---
title: "Financial indicators"
method: GET
path: "/intelligence/financials/{number}"
tags: ["Intelligence"]
---

# Financial indicators

`GET /intelligence/financials/{number}`

## Request

- Base URL: `https://api.companystack.co.uk`
- URL: `https://api.companystack.co.uk/intelligence/financials/{number}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

Accounts and charges facts from the register, not the filed figures: the accounts category, the last period made up to and the next due date, the accounting reference date, and the number of charges registered, outstanding and satisfied, with the same counts for the company's industry in `sector_comparison`. For the figures in the accounts use `GET /accounts/{number}`.

## Path parameters

- `number` string, required

## Response `200`

Financial analysis

## Other responses

- `401`: API key missing, malformed or revoked
- `403`: The key's plan does not include this endpoint (`code: plan_upgrade_required`, with `upgrade_url`), the key may not call it, or the key is beyond the plan's key limit after a downgrade (`code: key_limit_exceeded`: the newest keys are paused until keys are deleted or the plan upgraded)
- `429`: Per-minute or per-day limit reached (`code: rate_limited`, `window: minute|day`). Wait `Retry-After` seconds; when both windows are full the day is reported. A refused request does not count against either limit. A bulk lookup (`POST /company/bulk`) counts each company number in it as one request, so one that is more than you have left is refused whole, and the body adds `requested` and `fits`.

---

[API](https://skmtc.dev/companystack/apis/companystack-api.md) · [All operations](https://skmtc.dev/companystack/apis/companystack-api/llms.txt) · [OpenAPI document](https://skmtc.dev/companystack/apis/companystack-api/revisions/8f3234237d2d?raw)
