Intelligence

Filed accounts, year by year

Every year of accounts figures held for a company, newest first, with ratios and where each year's figures came from. A company that heads a group files two sets of figures for a year: its own (basis company) and the consolidated group's (basis group). By default one row per year is returned, the group figures where they are held and the company figures otherwise; basis selects one basis only. Every row states its basis, and bases counts the years held on each.

On the Free plan: 100 calls a UTC day to this endpoint and GET /accounts/{number} together, inside the daily request limit. Each such call carries X-Preview-Daily-Limit, X-Preview-Daily-Remaining and X-Preview-Daily-Reset (Unix time of the next midnight UTC); when the day's calls are used the answer is 429 with code: preview_limit_reached, not counted against the request limit. Starter and above have no separate limit.

get/accounts/{number}

Request

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

Path parameters

numberstring required

Query parameters

basis'presented' | 'group' | 'company'

presented: one row per year, group figures where held, else company figures. group: consolidated figures only. company: the legal entity's own figures only. Years held only on the other basis are left out.

limitinteger

Years to return, newest first (capped by your plan: history_limited_to)

Response

Accounts held for the company (an empty list when none)

company_numberstring required
totalinteger required

Years returned

years_availableinteger required

Years held on the basis requested (distinct balance-sheet dates for presented)

basis'presented' | 'group' | 'company' required

The basis requested

noticestring

Who the data is prepared for and that CompanyStack accepts no responsibility to anyone else who relies on it (Terms 15B). Keep it with the data if you show it to others (Terms 17.5).

history_limited_tointeger

Present when the plan caps the years shown

readingobject nullable

When no figures are held: the state of reading the filed documents (queued, reading, review, done, failed)

Changes

No recorded changes to this operation across all 1 revision of this API.