United States
United States Patent and Trademark Office

USPTO Trademark

Retrieve one US federal trademark application or registration by its eight-digit serial number, e.g. 79392077: the mark, its status and dates, classes, goods and services, filing basis, owners, attorney and whether an assignment was recorded. Served by Croma from its copy of the register (as_of says how current the data is).

Dataset endpoint: answers from the whole source in milliseconds and carries as_of.

post/us/uspto/trademark/v1

Request

  • Base URL: https://api.croma.run
  • URL: https://api.croma.run/us/uspto/trademark/v1
  • Auth: HTTP bearer

Headers

Idempotency-Keystring
Example:0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b

Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the Idempotency-Key response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit.

Request body

serial_numberstring required

The mark's eight-digit serial number, assigned when the application was filed, e.g. 79392077.

Response

Successful response

Changes

No recorded changes to this operation across all 1 revision of this API.