Try the API without a key

These four requests are answered here without a key, so you can see what the API sends back. Each one is shown as the curl command you would send with your own key; YOUR_KEY stands for it.

The demo runs only these requests, at most 20 an hour from one address and 2,000 a day for everyone. For anything else, get a free key: 1,000 requests a month.

One patent by its number

The record of US 10905426: its title, grant date and type, its assignee and its inventors.

curl -s -G -H "X-Api-Key: YOUR_KEY" https://patentref.io/api/v1/patent/ \
  --data-urlencode 'q={"patent_id":"10905426"}' \
  --data-urlencode 'f=["patent_id","patent_title","patent_date","patent_type","assignees.assignee_organization","inventors.inventor_name_first","inventors.inventor_name_last"]'

Run this request

Grants to one assignee in one year

Patents granted to Tesla, Inc. in 2024, oldest first, the first ten of them; total_hits counts them all.

curl -s -G -H "X-Api-Key: YOUR_KEY" https://patentref.io/api/v1/patent/ \
  --data-urlencode 'q={"_and":[{"assignees.assignee_organization":"Tesla, Inc."},{"_gte":{"patent_date":"2024-01-01"}},{"_lte":{"patent_date":"2024-12-31"}}]}' \
  --data-urlencode 'f=["patent_id","patent_title","patent_date"]' \
  --data-urlencode 's=[{"patent_date":"asc"},{"patent_id":"asc"}]' \
  --data-urlencode 'o={"size":10}'

Run this request

The claims of one patent

The first three claims of US 10905426, word for word, in their order; total_hits counts them all.

curl -s -G -H "X-Api-Key: YOUR_KEY" https://patentref.io/api/v1/g_claim/ \
  --data-urlencode 'q={"patent_id":"10905426"}' \
  --data-urlencode 'f=["patent_id","claim_sequence","claim_number","claim_dependent","claim_text"]' \
  --data-urlencode 's=[{"claim_sequence":"asc"}]' \
  --data-urlencode 'o={"size":3}'

Run this request

Expiry and maintenance-fee status

PatentRef's lapse group for US 10905426: what the USPTO record shows about its term and its maintenance fees, with the basis and the as-of date.

curl -s -G -H "X-Api-Key: YOUR_KEY" https://patentref.io/api/v1/patent/ \
  --data-urlencode 'q={"patent_id":"10905426"}' \
  --data-urlencode 'f=["patent_id","patent_title","lapse"]'

Run this request