---
title: "One entity with aliases and portfolio counts"
method: GET
path: "/v1/entities/{entity_id}"
tags: ["patent status"]
---

# One entity with aliases and portfolio counts

`GET /v1/entities/{entity_id}`

## Request

- Base URL: `https://api.patentdata.ai`
- URL: `https://api.patentdata.ai/v1/entities/{entity_id}`
- Auth: one of:
  - API key in header `X-API-KEY`
  - HTTP bearer

Answers: who is this entity id (or `fam_...` family id) — canonical name, name variants, location, `family_id`, and how many applications / patents / pending applications it has (a family's counts span its `members`).

## Path parameters

- `entity_id` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/patentdata/apis/patent-status-api.md) · [All operations](https://skmtc.dev/patentdata/apis/patent-status-api/llms.txt) · [OpenAPI document](https://skmtc.dev/patentdata/apis/patent-status-api/revisions/320133a82b42?raw)