---
title: "Api Patents"
method: GET
path: "/api/patents"
tags: ["Research"]
---

# Api Patents

`GET /api/patents`

## Request

- Base URL: `https://www.oxfordledge.com` (the document declares no server; this is the origin it was published from)
- URL: `https://www.oxfordledge.com/api/patents`
- Auth: none declared

SF-6 slice-2: recent USPTO patent APPLICATIONS for a ticker.

FREE public USPTO Open Data Portal data — no tier gate
(`sf_monetization_v3`: no paywall on free-source government data).
Application-centric: the ODP feed returns APPLICATIONS, not grants;
`patent_number` on a row is the granted PARENT for continuations, never
"this application was granted" (the slice-2 honest-labeling invariant —
same posture as the FMP-index-403 honesty fix).

Error/empty path returns `applications: []` (never a missing key) so
frontend list-iteration can't NPE — the /api/insiders 2026-04-26 class.

## Query parameters

- `ticker` string, nullable
- `limit` integer

## Response `200`

Successful Response

- PatentsResponse: `GET /api/patents?ticker=` — recent USPTO patent applications for a ticker. FREE public USPTO ODP data (no tier gate per sf_monetization_v3). Required: ticker, applications list (may be empty), data_source.
  - `ticker` string, required: Requested ticker, uppercased.
  - `applicant_name` string, nullable: Resolved applicant (company) name, when known.
  - `applications` PatentFilingItem[], required: Newest-filed first (empty when none ingested).
    - `application_number` string, required: USPTO application number (the row key).
    - `title` string, nullable: Invention title as filed.
    - `filing_date` string, nullable: Application filing date (YYYY-MM-DD).
    - `status` string, nullable: USPTO application status text.
    - `application_type` string, nullable: ODP application type (e.g. UTILITY).
    - `publication_number` string, nullable: Pre-grant publication number, when published.
    - `patent_number` string, nullable: Granted PARENT patent number for continuations; None otherwise.
  - `data_source` string, required: Provenance ('USPTO Open Data Portal').

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/oxfordledge/apis/oxford-ledge-api.md) · [All operations](https://skmtc.dev/oxfordledge/apis/oxford-ledge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/oxfordledge/apis/oxford-ledge-api/revisions/e832a1260f0b?raw)
