retrieve-token-status-response.md

Retrieve Token Status Response

Defines the fields that are included in the response body of a request to the RetrieveTokenStatus endpoint.

Structure

Retrieve Token Status Response

Fields

Name	Type	Tags	Description
scopes	List[str]	Optional	The list of scopes associated with an access token.
expires_at	str	Optional	The date and time when the access_token expires, in RFC 3339 format. Empty if the token never expires.
client_id	str	Optional	The Square-issued application ID associated with the access token. This is the same application ID used to obtain the token. Constraints: Maximum Length: 191
merchant_id	str	Optional	The ID of the authorizing merchant's business. Constraints: Minimum Length: 8, Maximum Length: 191
errors	List Error	Optional	Any errors that occurred during the request.

Example (as JSON)

{
  "client_id": "CLIENT_ID",
  "expires_at": "2022-10-14T14:44:00Z",
  "merchant_id": "MERCHANT_ID",
  "scopes": [
    "PAYMENTS_READ",
    "PAYMENTS_WRITE"
  ],
  "errors": [
    {
      "category": "MERCHANT_SUBSCRIPTION_ERROR",
      "code": "MAP_KEY_LENGTH_TOO_LONG",
      "detail": "detail6",
      "field": "field4"
    },
    {
      "category": "MERCHANT_SUBSCRIPTION_ERROR",
      "code": "MAP_KEY_LENGTH_TOO_LONG",
      "detail": "detail6",
      "field": "field4"
    }
  ]
}