find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/us-patent-and-trademark-office-case-status-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: USPTO Trademark Status and Document Retrieval Case Status API
  description: The USPTO Trademark Status and Document Retrieval (TSDR) REST API provides programmatic access to trademark case status, associated documents, case images, and related metadata. An API key is required for bulk data downloads.
  version: 1.0.0
  contact:
    name: USPTO
    email: TEAS@uspto.gov
    url: https://developer.uspto.gov/api-catalog/tsdr-data-api
servers:
- url: https://tsdrapi.uspto.gov
security:
- ApiKeyAuth: []
tags:
- name: Case Status
  description: Retrieve trademark case status and metadata
paths:
  /ts/cd/caseMultiStatus/{type}:
    get:
      tags:
      - Case Status
      operationId: getMultipleCaseStatus
      summary: Get Multiple Trademark Case Status
      description: Retrieve status information for multiple trademark cases at once.
      parameters:
      - name: type
        in: path
        required: true
        description: Response format type (json, xml)
        schema:
          type: string
          enum:
          - json
          - xml
      - name: sn
        in: query
        description: Serial numbers (comma-separated)
        schema:
          type: string
      - name: rn
        in: query
        description: Registration numbers (comma-separated)
        schema:
          type: string
      responses:
        '200':
          description: Trademark case status information
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CaseStatusResponse'
        '400':
          description: Bad Request
        '403':
          description: Forbidden - API key required
        '404':
          description: Not Found
  /ts/cd/casestatus/{caseid}/content.pdf:
    get:
      tags:
      - Case Status
      operationId: getCaseStatusPdf
      summary: Get Trademark Case Status as PDF
      parameters:
      - name: caseid
        in: path
        required: true
        description: Trademark serial or registration number
        schema:
          type: string
      responses:
        '200':
          description: PDF of case status
          content:
            application/pdf:
              schema:
                type: string
                format: binary
        '404':
          description: Not Found
  /last-update/info.json:
    get:
      tags:
      - Case Status
      operationId: getLastUpdateInfo
      summary: Get TSDR System Last Update Info
      description: Returns the date/time of the last TSDR data update.
      security: []
      responses:
        '200':
          description: Last update information
          content:
            application/json:
              schema:
                type: object
                properties:
                  lastUpdateDate:
                    type: string
                    format: date-time
components:
  schemas:
    CaseStatusResponse:
      type: object
      description: Trademark case status response
      properties:
        trademarkStatusCode:
          type: string
          description: Trademark status code
        trademarkStatusDate:
          type: string
          format: date
          description: Date of current status
        markLiteralElements:
          type: string
          description: Text elements of the trademark mark
        serialNumber:
          type: string
          description: Application serial number
        registrationNumber:
          type: string
          description: Registration number (if registered)
        filingDate:
          type: string
          format: date
        registrationDate:
          type: string
          format: date
        ownerName:
          type: string
        ownerAddress:
          type: string
        goodsAndServices:
          type: string
          description: Description of goods and services
        internationalClassCodes:
          type: array
          items:
            type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: USPTO-API-KEY