Retrieve a company

Returns one commercially cleared company by UUIDv7, including inactive or merged lifecycle state when that company was previously published.

GET/v0/companies/{company_id}

Authentication

bearerAuth · http bearer

Organisation API key supplied only through the Authorization header.

Required scopes: companies:read.

Parameters

Name	Type	Description
`company_id`required	string<uuid>path	UUIDv7 identifier of a commercially cleared company. Schema and examples `string<uuid>` UUIDv7 identifier of a commercially cleared company. Format `uuid` Pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$`

Responses

The requested company.

application/json

Luranta-Cost-USDoptional

Credit consumed as a USD decimal string. Present only on successful billable responses.

string

Pattern: ^(?:0|[1-9]\d*)\.\d{2,6}$

Luranta-Credit-Balance-USDoptional

Organisation credit remaining after settlement. Present only on successful billable responses.

string

Pattern: ^(?:0|[1-9]\d*)\.\d{2,6}$

Luranta-Resources-Returnedoptional

Number of resources returned and charged. Present only on successful billable responses.

integer

Minimum: 0

traceparentrequired

W3C trace context generated for this request attempt.

string

Pattern: ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$

X-Request-Idrequired

Unique UUIDv7 identifier for this request attempt.

string<uuid>

Format: uuid

CompanyCompany

Additional properties: forbidden

Properties

countryrequired

string | null

anyOf

Option 1

string

Pattern: ^[A-Z]{2}$

Option 2

null

idrequired

string<uuid>

Format: uuid
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$

industriesrequired

string[]

Maximum items: 20

Items

string

Maximum length: 160
Minimum length: 1
Pattern: ^[a-z0-9]+(?:[-_.][a-z0-9]+)*$

logo_urlrequired

string<uri> | null

anyOf

Option 1

string<uri>

Format: uri
Maximum length: 2048

Option 2

null

merged_into_idrequired

string<uuid> | null

anyOf

Option 1

string<uuid>

Format: uuid
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$

Option 2

null

namerequired

string

Maximum length: 240
Minimum length: 1

objectrequired

string

Constant: company

open_job_countrequired

integer

Maximum: 9007199254740991
Minimum: 0

statusrequired

string

Allowed values: ["active","inactive","merged"]

typerequired

string

Allowed values: ["company","brand","government","education","healthcare","nonprofit","partnership","agency","other"]

website_urlrequired

string<uri> | null

anyOf

Option 1

string<uri>

Format: uri
Maximum length: 2048

Option 2

null

The request contains an invalid parameter, parameter combination, or cursor.

This response uses Problem Details.

application/problem+json

traceparentrequired

W3C trace context generated for this request attempt.

string

Pattern: ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$

X-Request-Idrequired

Unique UUIDv7 identifier for this request attempt.

string<uuid>

Format: uuid

ProblemDetailsProblemDetails

Additional properties: forbidden

Properties

available_credit_usdoptional

string

Pattern: ^(?:0|[1-9]\d*)\.\d{2,6}$

coderequired

string

Maximum length: 80
Minimum length: 1

detailrequired

string

Maximum length: 1000
Minimum length: 1

errorsoptional

object[]

Maximum items: 100

Items

object

Additional properties: forbidden

Properties

coderequired

string

Maximum length: 80
Minimum length: 1

messagerequired

string

Maximum length: 500
Minimum length: 1

pointerrequired

string

Pattern: ^\/.*

instancerequired

string

Pattern: ^\/.*

paramoptional

string

Maximum length: 160
Minimum length: 1

request_idrequired

string<uuid>

Format: uuid
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$

required_credit_usdoptional

string

Pattern: ^(?:0|[1-9]\d*)\.\d{2,6}$

retryablerequired

boolean

statusrequired

integer

Maximum: 599
Minimum: 400

titlerequired

string

Maximum length: 120
Minimum length: 1

top_up_urloptional

string<uri>

Format: uri
Maximum length: 2048

typerequired

string<uri>

Format: uri
Maximum length: 2048

The organisation API key is missing, invalid, expired, or revoked.

This response uses Problem Details.

application/problem+json

traceparentrequired

W3C trace context generated for this request attempt.

string

Pattern: ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$

X-Request-Idrequired

Unique UUIDv7 identifier for this request attempt.

string<uuid>

Format: uuid

ProblemDetailsProblemDetails

Additional properties: forbidden

Properties

available_credit_usdoptional

string

Pattern: ^(?:0|[1-9]\d*)\.\d{2,6}$

coderequired

string

Maximum length: 80
Minimum length: 1

detailrequired

string

Maximum length: 1000
Minimum length: 1

errorsoptional

object[]

Maximum items: 100

Items

object

Additional properties: forbidden

Properties

coderequired

string

Maximum length: 80
Minimum length: 1

messagerequired

string

Maximum length: 500
Minimum length: 1

pointerrequired

string

Pattern: ^\/.*

instancerequired

string

Pattern: ^\/.*

paramoptional

string

Maximum length: 160
Minimum length: 1

request_idrequired

string<uuid>

Format: uuid
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$

required_credit_usdoptional

string

Pattern: ^(?:0|[1-9]\d*)\.\d{2,6}$

retryablerequired

boolean

statusrequired

integer

Maximum: 599
Minimum: 400

titlerequired

string

Maximum length: 120
Minimum length: 1

top_up_urloptional

string<uri>

Format: uri
Maximum length: 2048

typerequired

string<uri>

Format: uri
Maximum length: 2048

The organisation does not have enough credit to reserve this operation.

This response uses Problem Details.

application/problem+json

traceparentrequired

W3C trace context generated for this request attempt.

string

Pattern: ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$

X-Request-Idrequired

Unique UUIDv7 identifier for this request attempt.

string<uuid>

Format: uuid

ProblemDetailsProblemDetails

Additional properties: forbidden

Properties

available_credit_usdoptional

string

Pattern: ^(?:0|[1-9]\d*)\.\d{2,6}$

coderequired

string

Maximum length: 80
Minimum length: 1

detailrequired

string

Maximum length: 1000
Minimum length: 1

errorsoptional

object[]

Maximum items: 100

Items

object

Additional properties: forbidden

Properties

coderequired

string

Maximum length: 80
Minimum length: 1

messagerequired

string

Maximum length: 500
Minimum length: 1

pointerrequired

string

Pattern: ^\/.*

instancerequired

string

Pattern: ^\/.*

paramoptional

string

Maximum length: 160
Minimum length: 1

request_idrequired

string<uuid>

Format: uuid
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$

required_credit_usdoptional

string

Pattern: ^(?:0|[1-9]\d*)\.\d{2,6}$

retryablerequired

boolean

statusrequired

integer

Maximum: 599
Minimum: 400

titlerequired

string

Maximum length: 120
Minimum length: 1

top_up_urloptional

string<uri>

Format: uri
Maximum length: 2048

typerequired

string<uri>

Format: uri
Maximum length: 2048

The authenticated organisation lacks the required scope, or the browser origin is not allowed.

This response uses Problem Details.

application/problem+json

traceparentrequired

W3C trace context generated for this request attempt.

string

Pattern: ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$

X-Request-Idrequired

Unique UUIDv7 identifier for this request attempt.

string<uuid>

Format: uuid

ProblemDetailsProblemDetails

Additional properties: forbidden

Properties

available_credit_usdoptional

string

Pattern: ^(?:0|[1-9]\d*)\.\d{2,6}$

coderequired

string

Maximum length: 80
Minimum length: 1

detailrequired

string

Maximum length: 1000
Minimum length: 1

errorsoptional

object[]

Maximum items: 100

Items

object

Additional properties: forbidden

Properties

coderequired

string

Maximum length: 80
Minimum length: 1

messagerequired

string

Maximum length: 500
Minimum length: 1

pointerrequired

string

Pattern: ^\/.*

instancerequired

string

Pattern: ^\/.*

paramoptional

string

Maximum length: 160
Minimum length: 1

request_idrequired

string<uuid>

Format: uuid
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$

required_credit_usdoptional

string

Pattern: ^(?:0|[1-9]\d*)\.\d{2,6}$

retryablerequired

boolean

statusrequired

integer

Maximum: 599
Minimum: 400

titlerequired

string

Maximum length: 120
Minimum length: 1

top_up_urloptional

string<uri>

Format: uri
Maximum length: 2048

typerequired

string<uri>

Format: uri
Maximum length: 2048

The requested resource does not exist or is not available to this organisation.

This response uses Problem Details.

application/problem+json

traceparentrequired

W3C trace context generated for this request attempt.

string

Pattern: ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$

X-Request-Idrequired

Unique UUIDv7 identifier for this request attempt.

string<uuid>

Format: uuid

ProblemDetailsProblemDetails

Additional properties: forbidden

Properties

available_credit_usdoptional

string

Pattern: ^(?:0|[1-9]\d*)\.\d{2,6}$

coderequired

string

Maximum length: 80
Minimum length: 1

detailrequired

string

Maximum length: 1000
Minimum length: 1

errorsoptional

object[]

Maximum items: 100

Items

object

Additional properties: forbidden

Properties

coderequired

string

Maximum length: 80
Minimum length: 1

messagerequired

string

Maximum length: 500
Minimum length: 1

pointerrequired

string

Pattern: ^\/.*

instancerequired

string

Pattern: ^\/.*

paramoptional

string

Maximum length: 160
Minimum length: 1

request_idrequired

string<uuid>

Format: uuid
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$

required_credit_usdoptional

string

Pattern: ^(?:0|[1-9]\d*)\.\d{2,6}$

retryablerequired

boolean

statusrequired

integer

Maximum: 599
Minimum: 400

titlerequired

string

Maximum length: 120
Minimum length: 1

top_up_urloptional

string<uri>

Format: uri
Maximum length: 2048

typerequired

string<uri>

Format: uri
Maximum length: 2048

The server did not complete the request in time. This failure is non-billable and may be retried.

This response uses Problem Details.

application/problem+json

Retry-Afteroptional

Minimum number of seconds before retrying when supplied.

integer

Minimum: 0

traceparentrequired

W3C trace context generated for this request attempt.

string

Pattern: ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$

X-Request-Idrequired

Unique UUIDv7 identifier for this request attempt.

string<uuid>

Format: uuid

ProblemDetailsProblemDetails

Additional properties: forbidden

Properties

available_credit_usdoptional

string

Pattern: ^(?:0|[1-9]\d*)\.\d{2,6}$

coderequired

string

Maximum length: 80
Minimum length: 1

detailrequired

string

Maximum length: 1000
Minimum length: 1

errorsoptional

object[]

Maximum items: 100

Items

object

Additional properties: forbidden

Properties

coderequired

string

Maximum length: 80
Minimum length: 1

messagerequired

string

Maximum length: 500
Minimum length: 1

pointerrequired

string

Pattern: ^\/.*

instancerequired

string

Pattern: ^\/.*

paramoptional

string

Maximum length: 160
Minimum length: 1

request_idrequired

string<uuid>

Format: uuid
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$

required_credit_usdoptional

string

Pattern: ^(?:0|[1-9]\d*)\.\d{2,6}$

retryablerequired

boolean

statusrequired

integer

Maximum: 599
Minimum: 400

titlerequired

string

Maximum length: 120
Minimum length: 1

top_up_urloptional

string<uri>

Format: uri
Maximum length: 2048

typerequired

string<uri>

Format: uri
Maximum length: 2048

The organisation request rate was exceeded. Retry after the indicated delay.

This response uses Problem Details.

application/problem+json

Retry-Afteroptional

Minimum number of seconds before retrying when supplied.

integer

Minimum: 0

traceparentrequired

W3C trace context generated for this request attempt.

string

Pattern: ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$

X-Request-Idrequired

Unique UUIDv7 identifier for this request attempt.

string<uuid>

Format: uuid

ProblemDetailsProblemDetails

Additional properties: forbidden

Properties

available_credit_usdoptional

string

Pattern: ^(?:0|[1-9]\d*)\.\d{2,6}$

coderequired

string

Maximum length: 80
Minimum length: 1

detailrequired

string

Maximum length: 1000
Minimum length: 1

errorsoptional

object[]

Maximum items: 100

Items

object

Additional properties: forbidden

Properties

coderequired

string

Maximum length: 80
Minimum length: 1

messagerequired

string

Maximum length: 500
Minimum length: 1

pointerrequired

string

Pattern: ^\/.*

instancerequired

string

Pattern: ^\/.*

paramoptional

string

Maximum length: 160
Minimum length: 1

request_idrequired

string<uuid>

Format: uuid
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$

required_credit_usdoptional

string

Pattern: ^(?:0|[1-9]\d*)\.\d{2,6}$

retryablerequired

boolean

statusrequired

integer

Maximum: 599
Minimum: 400

titlerequired

string

Maximum length: 120
Minimum length: 1

top_up_urloptional

string<uri>

Format: uri
Maximum length: 2048

typerequired

string<uri>

Format: uri
Maximum length: 2048

The service or durable usage settlement is temporarily unavailable. This failure is non-billable.

This response uses Problem Details.

application/problem+json

Retry-Afteroptional

Minimum number of seconds before retrying when supplied.

integer

Minimum: 0

traceparentrequired

W3C trace context generated for this request attempt.

string

Pattern: ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$

X-Request-Idrequired

Unique UUIDv7 identifier for this request attempt.

string<uuid>

Format: uuid

ProblemDetailsProblemDetails

Additional properties: forbidden

Properties

available_credit_usdoptional

string

Pattern: ^(?:0|[1-9]\d*)\.\d{2,6}$

coderequired

string

Maximum length: 80
Minimum length: 1

detailrequired

string

Maximum length: 1000
Minimum length: 1

errorsoptional

object[]

Maximum items: 100

Items

object

Additional properties: forbidden

Properties

coderequired

string

Maximum length: 80
Minimum length: 1

messagerequired

string

Maximum length: 500
Minimum length: 1

pointerrequired

string

Pattern: ^\/.*

instancerequired

string

Pattern: ^\/.*

paramoptional

string

Maximum length: 160
Minimum length: 1

request_idrequired

string<uuid>

Format: uuid
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$

required_credit_usdoptional

string

Pattern: ^(?:0|[1-9]\d*)\.\d{2,6}$

retryablerequired

boolean

statusrequired

integer

Maximum: 599
Minimum: 400

titlerequired

string

Maximum length: 120
Minimum length: 1

top_up_urloptional

string<uri>

Format: uri
Maximum length: 2048

typerequired

string<uri>

Format: uri
Maximum length: 2048

Pricing

Property	Value
Count path	`.`
Meter	`company_resource`
Model	`returned_resource`
Resource	`company`