---
title: "Newly incorporated companies"
method: GET
path: "/company/recent"
tags: ["Companies"]
---

# Newly incorporated companies

`GET /company/recent`

## Request

- Base URL: `https://api.companystack.co.uk`
- URL: `https://api.companystack.co.uk/company/recent`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

Companies incorporated in the last `days` days, newest first, then by name: the same company profile as `GET /company/{number}` for each. Free plan: the first page only. `offset` is not applied and the answer carries `paging_limited`, the ignored `requested_offset`, a `notice` and an `upgrade_url`, as on `GET /company/search`. For filters (industry, place, director history) and saved searches use `GET /incorporations`.

## Query parameters

- `days` integer
- `limit` integer
- `offset` integer

## Response `200`

The newest companies, with the number incorporated in the period

- object
  - `period_days` integer, required
  - `total` integer, required: Companies incorporated in the period
  - `limit` integer, required
  - `offset` integer, required
  - `paging_limited` boolean: Present and true when the plan limits paging
  - `results` Company[], required
    - `company_number` string, required: 8 characters, e.g. 00445790 or SC586124
    - `company_name` string, required
    - `company_status` string, required: e.g. active, dissolved, liquidation
    - `company_type` string
    - `date_of_creation` string, date
    - `dissolution_date` string, date
    - `registered_office_address` string: The registered office as one comma-separated line
    - `registrar_default_address` object: Present only when Companies House has removed the company's registered office and put it at the registrar's default address (PO Box 4385, Cardiff CF14 8LH; PO Box 24238, Edinburgh EH7 9HR; or BT1 9DY, Belfast). The address above is then that default address, not the company's own.
      - `at_default_address` true, required
      - `statement` string, required
      - `changed_on` string, date, nullable, required: The day Companies House changed the registered office, from the filing history CompanyStack holds; null when not held
    - `country_of_origin` string
    - `sic_codes` SicCode[]
      - `code` string, required
      - `description` string
    - `accounts` object
      - `next_due` string, date
      - `last_made_up_to` string, date
      - `category` string
      - `reference_day` integer
      - `reference_month` integer
      - `overdue` boolean
    - `confirmation_statement` object
      - `next_due` string, date
      - `last_made_up_to` string, date
      - `overdue` boolean
    - `mortgages` object
      - `total_count` integer
      - `outstanding_count` integer
      - `part_satisfied_count` integer
      - `satisfied_count` integer
    - `previous_names` object[]
      - `name` string
      - `changed_on` string, date
    - `data_freshness` object: How current the register entry is. as_at is the date to quote: the later of the latest monthly Companies House snapshot that listed the company and the last update from the Companies House stream or API. last_updated is when CompanyStack last rewrote the row, which an unchanged company keeps from an older snapshot.
      - `as_at` string, date: The date the register entry is known current as at (YYYY-MM-DD)
      - `last_updated` string
      - `source` string
      - `etag` string
    - `data_source` string
    - `entity_kind` 'company' | 'llp' | 'lp' | 'scottish_partnership' | 'overseas' | 'other': GET /company/{number} only. The kind of entity, decided from company_type and, only when that is missing or "Other company type", from the number prefix: company; llp (limited liability partnership); lp (limited partnership); scottish_partnership; overseas (overseas companies, UK establishments and overseas entities); other (for example charitable incorporated organisations, registered societies, royal charter bodies, ICVCs and economic interest groupings).
    - `people_term` object: GET /company/{number} only. What the people on the register are called for this kind of entity: officer and officers for a company (and for overseas and other bodies), member and members for an LLP, partner and partners for a partnership.
      - `one` string, required
      - `many` string, required
    - `limited_partnership` object: GET /company/{number} only, and only for a limited partnership whose register entry records at least one partner: the numbers of general and limited partners in Companies House's company data product.
      - `general_partners` integer, required
      - `limited_partners` integer, required

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