Errors

HTTP status codes and error responses returned by the Company Data Guys API.

The API returns JSON error bodies.

{
  "error": "Missing API key"
}

Returned with HTTP 401 when no supported API key header is present.

{
  "error": "Invalid API key"
}

Returned with HTTP 401 when the key is revoked, expired, malformed, or not found.

{
  "error": "Invalid request",
  "message": "URL must be a LinkedIn company, showcase, or school page: https://example.com"
}

Returned with HTTP 400 when the request body fails validation.

{
  "error": "Insufficient credits",
  "message": "Your credit balance is zero. Purchase more credits before sending new requests."
}

Returned with HTTP 402 when the account does not have enough credits for the request.