Get a company

Returns a single company by slug (e.g., ‘apple’), domain (e.g., ‘apple.com’), or ID.

GET /v1/companies/{id}

cURL

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/companies/{id}"

200

{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "identifiers": {
    "cik": "<string>",
    "domain": "<string>",
    "entity": {
      "id": "<string>",
      "name": "<string>",
      "slug": "<string>",
      "company": {
        "id": "<string>",
        "domain": "<string>",
        "ticker": "<string>"
      },
      "description": "<string>",
      "image_url": "<string>",
      "person": {
        "id": "<string>",
        "company": "<string>",
        "image_url": "<string>",
        "title": "<string>"
      },
      "type": {
        "name": "<string>",
        "slug": "<string>"
      },
      "wikipedia_url": "<string>"
    },
    "qid": "<string>",
    "ticker": "<string>"
  },
  "image_mode": "AUTOMATIC",
  "image_url": "<string>",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

ApiKeyHeaderBearerAuth

X-API-Key · string · header · required

Pass your API key in the X-API-Key header (recommended).

Path Parameters

id · string · required

Company slug (e.g., 'apple', 'tesla'), domain (e.g., 'apple.com'), or ID

Response

200

application/json

OK

id · string · required

Unique identifier

name · string · required

Company name

description · string

Company description

identifiers · object

External identifiers

Show child attributes

image_mode · enum<string>

Image presentation policy. AUTOMATIC permits client fallbacks, CUSTOM requires the supplied image_url, and NONE suppresses all image fallbacks.

Available options: AUTOMATIC, CUSTOM, NONE

image_url · string

Effective company image URL. Omitted when image_mode is NONE or no automatic image is available.

updated_at · string<date-time>

Last updated timestamp