---
title: "An entity's applications (portfolio), filterable by status"
method: GET
path: "/v1/entities/{entity_id}/applications"
tags: ["patent status"]
---

# An entity's applications (portfolio), filterable by status

`GET /v1/entities/{entity_id}/applications`

## Request

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

Answers: what has this company filed, and what is each filing's state right now. Each row carries the application's current `status` {code, description, category, bucket, date}, `patent_number` when granted, and the link `role`/`confidence`. `status` filters on USPTO's raw category: pending, granted, abandoned, allowed, expired, provisional, pct, other. `status.bucket` is what /v1/entities/{id}/stats counts (allowed folds into pending, expired-after-grant into granted, never-examined into other, null for an application we do not hold), so count buckets to reconcile a portfolio against the statistics. Newest serial first; paginate with `next_cursor`. Costs 1 unit per 100 rows.

## Path parameters

- `entity_id` string, required

## Query parameters

- `status` string, nullable: Status category filter: pending | granted | abandoned | allowed | expired | provisional | pct | other.
- `limit` integer: Page size. Each 100 rows returned costs 1 request unit.
- `cursor` string, nullable: Opaque cursor from a previous response's next_cursor. Omit for the first page.

## 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)