---
title: "Get info about the current access token"
method: GET
path: "/v1/token_info"
tags: ["Introspection"]
---

# Get info about the current access token

`GET /v1/token_info`

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

## Headers

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

## Response `200`

Success

- TokenInfo
  - `scope` string — Space-separated list of OAuth scopes granted to this access token.
  - `resource` object, nullable — The resource associated with this access token. Null when the token has no associated resource.
    - `type` string — The type of resource associated with the access token, e.g. `Company` for a company-level token or `Oauth::Application` for a system-level token.
    - `uuid` string, uuid — The UUID of the associated resource
  - `resource_owner` object, nullable — The resource owner (user) who authorized this access token. Null for system-level tokens or when the owner cannot be determined.
    - `type` 'CompanyAdmin' | 'Employee' | 'Contractor' — The type of resource owner: - `CompanyAdmin`: A company administrator - `Employee`: An employee - `Contractor`: A contractor
    - `uuid` string, uuid — The UUID of the resource owner

---

[API](https://skmtc.net/gusto/apis/gusto-api.md) · [All operations](https://skmtc.net/gusto/apis/gusto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gusto/gusto-api/revisions/826dfa57fb3b/schema)