# Patents (/docs/proof-points/patents)



Patent proof points are built from indexed patent documents. Date filters apply to **published date**.

**Endpoints:**

* `POST /proof-points/patents/search` — [playground](/docs/api-reference/endpoints/search_patents_proof_points_patents_search_post)
* `POST /proof-points/patents/time-series` — [playground](/docs/api-reference/endpoints/patents_time_series_proof_points_patents_time_series_post)
* `POST /proof-points/patents/correlation-matrix` — [playground](/docs/api-reference/endpoints/patents_correlation_matrix_proof_points_patents_correlation_matrix_post)

## Typical Questions [#typical-questions]

* Which topics show rising patent momentum?
* What are representative patents for this trend?
* Is activity concentrated in a few assignees or IPC classes?

## Type-specific filters [#type-specific-filters]

On top of the [shared proof-point fields](/docs/proof-points):

* `applicationNumbers`, `grantNumbers`, `publicationNumbers`
* `states` — prosecution stage (`applied`, `published`, `granted`)
* `ipc` — International Patent Classification codes

## Request Patterns [#request-patterns]

### Search [#search]

```json
{
  "query": "solid-state electrolyte",
  "topicIds": ["11111111-1111-1111-1111-111111111111"],
  "states": ["granted"],
  "start": "2022-01-01T00:00:00Z",
  "end": "2024-12-31T23:59:59Z",
  "take": 25,
  "sortColumn": "published_at",
  "sortDirection": "desc"
}
```

### Time series [#time-series]

```json
{
  "topicIds": ["11111111-1111-1111-1111-111111111111"],
  "resolution": "quarter",
  "start": "2020-01-01T00:00:00Z",
  "end": "2024-12-31T23:59:59Z"
}
```

## Response Notes [#response-notes]

Each patent can include `applicationNumber`, `grantNumber`, `publicationNumber`, `state`, `ipc`, plus the shared document fields (`title`, `publishedAt`, `topics`, `orgNodes`). Time series returns `labels` and `counts`.