---
title: "Bulk lookup (up to 100)"
method: POST
path: "/company/bulk"
tags: ["Companies"]
---

# Bulk lookup (up to 100)

`POST /company/bulk`

## Request

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

Full register profiles for up to 100 company numbers in one call (Business plan and above). Each company number in a bulk request counts as one request against your per-minute and daily limits, so a batch of 50 uses 50. A number repeated in the batch, or written with and without its leading zeros, counts once. A batch that is more than you have left of the minute or the day is refused with 429 and counts nothing; the body says how many numbers you sent (`requested`) and how many would fit (`fits`). A request the API rejects as invalid (more than 100 numbers, a malformed number) counts as one request. `X-RateLimit-Cost` on the response is the number of requests the batch counted, and the usual `X-RateLimit-*` headers show what is left.

## Request body

- object
  - `company_numbers` string[]

## Response `200`

Bulk results

## 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`: The batch is more than you have left of the minute or the day (`code: rate_limited`, `window: minute|day`). Nothing is counted. `requested` is the number of different company numbers you sent and `fits` how many the window named in `window` has room for. `Retry-After` is the seconds until that window resets

---

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