Client Application Token Response

The OAuth token response for third-party client applications to use to access USPS APIs. The access token is returned in the response. You may use [The Unix Epoch Time Converter](https://www.epochconverter.com/) to convert access token issued at values to human readable formats. Use the public key provided in the response to verify the access token signature.

GovernmentPostal ServiceShippingLogisticsAddress ValidationPackage Tracking

Properties

Name Type Description
access_token string The access token issued to use to acess protected resources.
issued_at integer The date and time the access token was issued, expressed in Unix epoch time in milliseconds. You may use [The Unix Epoch Time Converter](https://www.epochconverter.com/) to convert access token issued
expires_in integer The expiration time of the issued access token, in seconds.
token_type string The access token type provides the client with the information required to successfully utilize the access token to make a protected resource request (along with type-specific attributes). The client
status string The status of the access token.
issuer string The authority that issued the token(s).
scope string The OAuth scope being requested by the client application, specified as a list of space-delimited, case-sensitive strings. If ommitted from the token request then the default scope configured for the
client_id string The unique identifier for the client application.
application_name string The name of the client application.
api_products string The list of API products approved for use by the client application.
public_key string The base64-encoded public cryptographic key used to validate the signature of the access token. Validation ensures that the access token has not been tampered with and it originated from a known, trus
View JSON Schema on GitHub

JSON Schema

usps-client-application-token-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/usps/json-schema/usps-client-application-token-response-schema.json",
  "title": "Client Application Token Response",
  "description": "The OAuth token response for third-party client applications to use to access USPS APIs.\nThe access token is returned in the response. You may use [The Unix Epoch Time Converter](https://www.epochconverter.com/) to convert access token issued at values to human readable formats.\nUse the public key provided in the response to verify the access token signature.\n",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/usps-oauth-openapi.yml#/components/schemas/ClientApplicationTokenResponse",
  "readOnly": true,
  "required": [
    "access_token",
    "expires_in",
    "token_type"
  ],
  "properties": {
    "access_token": {
      "description": "The access token issued to use to acess protected resources.",
      "type": "string"
    },
    "issued_at": {
      "description": "The date and time the access token was issued, expressed in Unix epoch time in milliseconds.\nYou may use [The Unix Epoch Time Converter](https://www.epochconverter.com/) to convert access token issued at values to human readable formats.\n",
      "type": "integer",
      "format": "int64"
    },
    "expires_in": {
      "description": "The expiration time of the issued access token, in seconds.",
      "type": "integer"
    },
    "token_type": {
      "description": "The access token type provides the client with the information required to successfully utilize the access token to make a protected resource request (along with type-specific attributes).  The client MUST NOT use an access token if it does not understand the token type.",
      "type": "string",
      "enum": [
        "Bearer"
      ],
      "default": "Bearer"
    },
    "status": {
      "description": "The status of the access token.",
      "type": "string",
      "enum": [
        "approved",
        "revoked"
      ]
    },
    "issuer": {
      "description": "The authority that issued the token(s).",
      "type": "string",
      "format": "Uri"
    },
    "scope": {
      "description": "The OAuth scope being requested by the client application, specified as a list of space-delimited, case-sensitive strings.  If ommitted from the token request then the default scope configured for the client application is used.",
      "type": "string"
    },
    "client_id": {
      "description": "The unique identifier for the client application.",
      "type": "string"
    },
    "application_name": {
      "description": "The name of the client application.",
      "type": "string"
    },
    "api_products": {
      "description": "The list of API products approved for use by the client application.",
      "type": "string"
    },
    "public_key": {
      "description": "The base64-encoded public cryptographic key used to validate the signature of the access token.  Validation ensures that the access token has not been tampered with and it originated from a known, trusted source.",
      "type": "string",
      "format": "byte"
    }
  },
  "additionalProperties": false
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • 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 JSON Schema
curl "https://apis.io/api/v1/json-schemas/usps-client-application-token-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

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