---
title: "A company's register details for a card or the filing-deadlines tracker"
method: GET
path: "/elements/v1/card/{number}"
tags: ["Website components"]
---

# A company's register details for a card or the filing-deadlines tracker

`GET /elements/v1/card/{number}`

## Request

- Base URL: `https://api.companystack.co.uk`
- URL: `https://api.companystack.co.uk/elements/v1/card/{number}`
- Auth: one of:
  - API key in query parameter `key`
  - HTTP bearer

Counts one request the first time a key displays the company in a UTC day; every other view that day is free.

## Path parameters

- `number` string, required

## Query parameters

- `key` string
- `token` string

## Response `200`

The company

- object
  - `company` object
    - `company_number` string
    - `company_name` string
    - `company_status` string
    - `status_label` string
    - `active` boolean
    - `closed` boolean
    - `company_type` string, nullable
    - `jurisdiction` 'england_wales' | 'scotland' | 'northern_ireland' | 'overseas'
    - `incorporated_on` string, nullable
    - `dissolved_on` string, nullable
    - `registered_office` object
      - `care_of` string, nullable
      - `po_box` string, nullable
      - `address_line_1` string, nullable
      - `address_line_2` string, nullable
      - `locality` string, nullable
      - `region` string, nullable
      - `postal_code` string, nullable
      - `country` string, nullable
      - `full` string
      - `registrar_default` boolean: Companies House removed the registered office: the address is its default address, not the company's own
    - `sic_codes` object[]
      - `code` string
      - `description` string, nullable
    - `accounts` object
      - `next_due` string, nullable
      - `overdue` boolean
      - `last_made_up_to` string, nullable
    - `confirmation_statement` object
      - `next_due` string, nullable
      - `overdue` boolean
      - `last_made_up_to` string, nullable
    - `register_url` string
  - `as_of` string, nullable
  - `attribution` object: Show `text` with `licence` wherever the data is shown (the Open Government Licence asks for the statement).
    - `text` string
    - `licence` string
    - `licence_url` string
    - `affiliation` string
    - `url` string

## Other responses

- `400`: Missing or malformed session, or an invalid company number
- `401`: No key, or an invalid or revoked key
- `403`: A publishable key or token from a website it does not list (`origin_not_allowed`: no Access-Control-Allow-Origin, so the page cannot read the answer and nothing is counted), a secret key sent from a browser (`secret_key_in_browser`), an endpoint a publishable key cannot reach (`secret_key_required`), or a scope or company a token does not cover (`scope_not_allowed`, `company_not_allowed`)
- `404`: Not found (not counted)
- `429`: A per-visitor or per-key limit (`rate_limited`), the end of a session (`session_exhausted`: start a new one), the key's daily cap (`key_daily_cap`) or the account's quota (`quota_exceeded`). Retry-After says when to try again.

---

[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)