---
title: "Get an entity"
method: GET
path: "/v1/entities/{id}"
tags: ["Entities", "tier:standard"]
---

# Get an entity

`GET /v1/entities/{id}`

## Request

- Base URL: `https://api.particle.pro`
- URL: `https://api.particle.pro/v1/entities/{id}`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Returns a single knowledge graph entity by slug (e.g., 'sam-altman', 'apple') or ID. A person slug or ID (as returned by a `person` hit on /v1/entities/search) also resolves, to that person's linked knowledge graph entity.

## Path parameters

- `id` string, required: Entity slug (e.g., 'sam-altman', 'apple') or ID

## Response `200`

OK

- Entity
  - `company` EntityCompany
    - `domain` string: Company website domain
    - `id` string, required: Company identifier
    - `ticker` string: Primary stock ticker symbol
  - `description` string: Short description
  - `id` string, required: Unique identifier
  - `image_url` string: Entity image URL
  - `name` string, required: Entity name
  - `person` EntityPerson
    - `company` string: Current company name
    - `id` string, required: Person identifier
    - `image_url` string: Person headshot URL
    - `title` string: Current role title
  - `slug` string, required: Human-readable slug identifier
  - `type` EntityType
    - `name` string, required: Human-friendly display label (e.g. 'Company').
    - `slug` string, required: Stable identifier, safe to pass to the type query parameter (e.g. 'company').
  - `wikipedia_url` string: Wikipedia URL

## Other responses

- `402`: Payment Required. Read error_code. payment_required is the x402 path: either a keyless request being challenged — pay $0.01 in USDC per request (requirements in the PAYMENT-REQUIRED header) or send a pp_ API key — or a supplied payment that failed settlement (details in the PAYMENT-RESPONSE header; retry the same signature before signing a new one). See https://docs.particle.pro/x402. Any other code means the credential was accepted but does not cover this request (a plan or session gate such as premium_required or paid_plan_confirmation_required); its resolve says how to obtain access, and no payment header is sent.
- `default`: Error

---

[API](https://skmtc.dev/particle/apis/particle-api.md) · [All operations](https://skmtc.dev/particle/apis/particle-api/llms.txt) · [OpenAPI document](https://skmtc.dev/particle/apis/particle-api/revisions/416ba82ab9d7?raw)