v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Introspection

Get info about the current access token

Returns scope and resource information associated with the current access token. Use this endpoint to verify the following for the current access token:

Resource (company, employee, contractor, or application) and resource owner
Access level

get/v1/token_info

Headers

X-Gusto-API-Version'2026-06-15'

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Response

Success

scopestring

Space-separated list of OAuth scopes granted to this access token.

Example response

{
  "scope": "companies:read public",
  "resource": {
    "type": "Company",
    "uuid": "7b1d0df1-6403-4a06-8768-c1dd7d24d27a"
  },
  "resource_owner": {
    "type": "CompanyAdmin",
    "uuid": "8fdc31f0-a8a7-4872-a9f1-dcb5e6f876e3"
  }
}