Get a patent

GET /api/v2/external/patents/{patentId}

Authentication: x-api-key header, with the patents:read scope. See Authentication and limits.

Returns a single patent owned by the authenticated client, identified by its opaque Renewr UUID. To look a patent up by your own reference, use the list endpoint with ?providerId=.

Path parameters

Name	Type	Required	Description
patentId	string	Yes	The opaque, stable Renewr UUID of the patent.

Response

200 The patent matching the provided UUID.

{
  "object": "patent",
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "providerId": "ACME-2021-0042",
  "clientCaseReference": "P-2021-0042-EP",
  "clientFamilyReference": "FAM-0042",
  "title": "Heat exchanger with corrugated fins",
  "office": "EP",
  "patentType": "PATENT",
  "applicationNumber": "21305432.1",
  "applicationDate": "2021-04-02",
  "nationalPhaseEntryDate": null,
  "priorityDate": "2020-04-03",
  "publicationNumber": "EP3891234A1",
  "publicationDate": "2022-10-05",
  "grantPublicationNumber": "EP3891234B1",
  "grantDate": "2024-03-13",
  "pctApplicationNumber": "PCT/EP2021/059012",
  "expirationDate": "2041-04-02",
  "extendedExpirationDate": null,
  "lapseDate": null,
  "renewalsManagedFrom": "2021-04-02",
  "status": "GRANTED",
  "filingRoute": "EP",
  "applicantType": "LARGE",
  "claimCount": 15,
  "designatedCountries": [
    "DE",
    "FR",
    "GB",
    "IT"
  ],
  "owner": "Acme Industries SA",
  "secondaryOwners": [],
  "subCase": null,
  "createdAt": "2026-01-10T08:30:00.000Z",
  "updatedAt": "2026-07-15T14:00:00.000Z"
}

Response fields

Field	Type	Description
object	string	String describing the object type (auto-description). One of: patent.
id	string	Opaque, stable Renewr UUID of the patent. Format: uuid.
providerId	string or null	Client-provided matching reference; searchable via ?providerId=.
clientCaseReference	string or null	Case reference on the client side.
clientFamilyReference	string or null	Family reference on the client side.
title	string or null	Title of the patent.
office	string	Patent office / authority code (WO, EP, EA, or an ISO 3166-1 national office code).
patentType	string or null	One of: PATENT, UTILITY, DESIGN.
applicationNumber	string or null	Application (filing) number: DOCDB aligned.
applicationDate	string or null	ISO date string.
nationalPhaseEntryDate	string or null	ISO date string.
priorityDate	string or null	ISO date string.
publicationNumber	string or null	Publication number.
publicationDate	string or null	ISO date string.
grantPublicationNumber	string or null	Grant publication number.
grantDate	string or null	ISO date string.
pctApplicationNumber	string or null	PCT application number.
expirationDate	string or null	ISO date string.
extendedExpirationDate	string or null	ISO date string.
lapseDate	string or null	ISO date string.
renewalsManagedFrom	string or null	ISO date string.
status	string or null	Shared IP right status. One of: PENDING, PUBLISHED, GRANTED, LAPSED.
filingRoute	string or null	How the title was filed. One of: NATIONAL, PCT, EP, EA, DIVISIONAL.
applicantType	string or null	One of: MICRO, SMALL, LARGE.
claimCount	integer or null	Number of claims.
designatedCountries	array of string or null	ISO 3166-1 alpha-2 designations (EP/regional).
owner	string or null	Owner (display).
secondaryOwners	array of string or null	Co-owners.
subCase	string or null	Sub-case.
createdAt	string or null	ISO 8601 timestamp (UTC). Format: date-time.
updatedAt	string or null	ISO 8601 timestamp (UTC). Format: date-time.

Errors

Errors use the application/problem+json envelope with stable machine-readable codes. See the Errors guide.

Status	Description
400	Validation failed (validation_failed): carries per-field errors[] with RFC 6901 JSON Pointers.
401	Missing or invalid API key (invalid_api_key), or expired key (api_key_expired).
403	API key lacks the required scope (insufficient_scope, with requiredScope extension) or the operation is not enabled for this client (forbidden).
404	The resource does not exist in your portfolio (not_found).
429	Daily API call limit exceeded (rate_limit_exceeded): the Retry-After header gives the seconds until reset.

Example request

curl "https://api.renewr.example/api/v2/external/patents/$PATENT_ID" \
  -H "x-api-key: $RENEWR_API_KEY"