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>",
  "external_links": [
    {
      "platform": {
        "display_name": "<string>",
        "name": "<string>",
        "type": "podcast_directory"
      },
      "attributes": [
        {
          "name": "<string>",
          "value": "<unknown>",
          "category": "<string>",
          "observed_at": "2023-11-07T05:31:56Z"
        }
      ],
      "identifier": "<string>",
      "url": "<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_url": "<string>",
  "slug": "<string>",
  "updated_at": "2023-11-07T05:31:56Z"
}

Prefer the terminal? This endpoint is also a command in the Particle CLI: pick Particle CLI in the request example’s language menu. Install the Particle CLI.

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

external_links · object[] | null

Known third-party profiles and identifiers (LinkedIn, social, domain, Wikidata, SEC CIK, tickers). Returned by GET /v1/companies/{id}; the list endpoint omits it.

Show child attributes

identifiers · object

External identifiers

Show child attributes

image_url · string

Company logo or image URL, when available.

slug · string

Stable human-readable handle (the linked knowledge-graph slug, e.g. 'nvidia'), when known. Companies have no slug of their own; prefer this for display and pass it (or id) to /v1/companies.

updated_at · string<date-time>

Last updated timestamp