Skip to main content
POST
companies.registry.get

Authorizations

Authorization
string
header
required

API key: sk_live_…

Headers

Idempotency-Key
string

Optional. A retry with the same key returns the stored result.

Maximum string length: 255
Pramaan-Max-Price-Micro
string

Optional. The most this request may be priced at, in micro-USD (a whole number above 0). It replaces the capability's own price ceiling for this request, lower or higher. Sources that could cost more are left out; when none is left the answer is 400 with the lowest limit that would work.

Pattern: ^[1-9]\d{0,14}$

Body

application/json
registryNumber
string
required

The company's number on the register.

Required string length: 1 - 64
jurisdiction
string

Register jurisdiction code, e.g. "gb" or "us_ca". Omit it to look in the default register.

Required string length: 1 - 16

Response

The result

name
string
required

Registered company name.

registryNumber
string
required

The company's number on the register.

jurisdiction
string
required

Register jurisdiction code, e.g. "gb" or "us_ca".

status
string

Registered status, as the register records it.

statusDetail
string

Extra status detail, e.g. a pending strike-off.

type
string

Registered company type, e.g. a limited company.

incorporatedOn
string

Incorporation date, ISO 8601.

dissolvedOn
string

Dissolution or cessation date, ISO 8601.

registeredAddress
object

The company's registered address.

officers
object[]

Officers (directors and secretaries) on the register.

industryCodes
object[]

Registered industry (activity) codes.