API Reference
USPTO patent grants
Granted US patents, resolved to assignee entities.
USPTO patent grants
Granted US patents, resolved to assignee entities.
- Base URL:
https://api.clous.ai - Auth:
Authorization: Bearer clous_live_...
GET /v1/uspto-patent-grantsResults are returned through the standard response envelope and are cursor-paginated.
Query parameters
Prop
Type
Example request
curl -s "https://api.clous.ai/v1/uspto-patent-grants?limit=3" \
-H "Authorization: Bearer clous_live_..."import requests
resp = requests.get(
"https://api.clous.ai/v1/uspto-patent-grants",
params={"limit":"3"},
headers={"Authorization": "Bearer clous_live_..."},
)
data = resp.json()const resp = await fetch(
"https://api.clous.ai/v1/uspto-patent-grants?limit=3",
{ headers: { Authorization: "Bearer clous_live_..." } },
);
const data = await resp.json();Example response
{
"data": [
{
"patent_number": "D1127451",
"grant_date": "2026-05-26",
"grant_year": 2026,
"application_number": "29959616",
"application_date": "2024-08-27",
"title": "Shoe bench with drawers",
"kind_code": "S1",
"publication_country": "US",
"claims_count": 1,
"assignee_name": "Wuxi Housetex Industries Co., Ltd.",
"assignee_normalized": "wuxi housetex industries co",
"assignee_city": "Wuxi",
"assignee_state": null,
"assignee_country": "CN",
"assignee_count": 1,
"inventor_count": 1,
"cpc_codes": null,
"ipc_codes": null,
"assignees_json": "[{\"role\": null, \"org_name\": \"Wuxi Housetex Industries Co., Ltd.\", \"address_city\": \"Wuxi\", \"address_state\": null, \"address_country\": \"CN\", \"is_organization\": true, \"person_last_name\": null, \"person_first_name\": null, \"org_normalized_name\": \"wuxi housetex industries co\"}]",
"inventors_json": "[{\"last_name\": \"Tang\", \"first_name\": \"Hongyan\", \"address_city\": \"Wuxi\", \"address_state\": null, \"address_country\": \"CN\"}]",
"source_archive_week": "260526",
"last_observed_at": "2026-05-28T00:54:44"
},
{
"patent_number": "D1127450",
"grant_date": "2026-05-26",
"grant_year": 2026,
"application_number": "29995535",
"application_date": "2025-03-27",
"title": "Desk",
"kind_code": "S1",
"publication_country": "US",
"claims_count": 1,
"assignee_name": "Hangzhou Aojia Technology Co., Ltd.",
"assignee_normalized": "hangzhou aojia technology co",
"assignee_city": "Hangzhou City",
"assignee_state": null,
"assignee_country": "CN",
"assignee_count": 1,
"inventor_count": 1,
"cpc_codes": null,
"ipc_codes": null,
"assignees_json": "[{\"role\": null, \"org_name\": \"Hangzhou Aojia Technology Co., Ltd.\", \"address_city\": \"Hangzhou City\", \"address_state\": null, \"address_country\": \"CN\", \"is_organization\": true, \"person_last_name\": null, \"person_first_name\": null, \"org_normalized_name\": \"hangzhou aojia technology co\"}]",
"inventors_json": "[{\"last_name\": \"Zheng\", \"first_name\": \"Hongbing\", \"address_city\": \"Hangzhou\", \"address_state\": null, \"address_country\": \"CN\"}]",
"source_archive_week": "260526",
"last_observed_at": "2026-05-28T00:54:44"
}
],
"page": {
"limit": 3,
"next_cursor": "MjAyNjA1MjZ8RDExMjc0NDk",
"has_more": true
},
"as_of": "2026-06-13T16:27:36.099314Z",
"source": "uspto_patent_grants",
"query_echo": {
"limit": 3
},
"warnings": []
}Status codes
| Status | Meaning |
|---|---|
200 | Success. An empty result still returns 200 with data: [] and a warnings entry. |
401 | Missing or invalid API key. |
402 | Out of credits. |
404 | No record for the supplied path parameter. |
422 | Validation error — a parameter was the wrong type or out of range. |
429 | Rate limited. |
All data derives from public SEC EDGAR (and, where noted, FINRA IAPD / USPTO) filings. Clous is independent of the SEC.