---
title: "Get token identity"
method: GET
path: "/v1/identity/current"
tags: ["Identity"]
---

# Get token identity

`GET /v1/identity/current`

Shows information about the entities that can be controlled by the current auth token.

## Headers

- `Authorization` string, required

## Response `201`

Success

- union — The response from `GET /v1/identity/current`. Returns information about the entities associated with the current authentication token. The shape of the response depends on the type of token used: - **Client Credentials Token**: Returns the integration's `client_id` and details. No company or user context. - **Company Access Token** (Authorization Code flow): Returns full context — integration credentials, the company being accessed, and the authorizing user. - **Customer API Token**: Returns only the company and user. No integration credentials since the company is accessing its own data directly.
  - object — Returned when the current token was obtained via the OAuth2 Client Credentials flow. Contains the integration's client ID and details, but no company or user information since client credentials tokens are not scoped to a specific company.
    - `data` object, required
      - `client_id` string, required — The OAuth2 client ID used to obtain this token.
      - `integration` IdentityIntegration, required — Details about the integration partner associated with the current authentication token.
        - `contact_email` string, required — The primary contact email address registered for this integration partner.
        - `display_name` string, required — The human-readable display name of the integration partner, as shown to users.
        - `name` string, required — The unique machine-readable identifier for the integration partner. Used internally to reference this integration.
  - object — Returned when the current token was obtained via the OAuth2 Authorization Code flow and is scoped to a specific company managed by an integration partner. Contains the full context: the integration's credentials, the company being accessed, and the user who authorized access.
    - `data` object, required
      - `client_id` string, required — The OAuth2 client ID of the integration partner that obtained this token.
      - `company` IdentityCompany, required — The company that the current authentication token is scoped to. Only present when using a company-scoped access token or customer API token.
        - `id` string, required — The unique identifier (UUID) of the company. Use this ID when making subsequent API calls that require a company reference.
        - `name` string, required — The registered name of the company on the Remote platform.
      - `integration` IdentityIntegration, required — Details about the integration partner associated with the current authentication token.
        - `contact_email` string, required — The primary contact email address registered for this integration partner.
        - `display_name` string, required — The human-readable display name of the integration partner, as shown to users.
        - `name` string, required — The unique machine-readable identifier for the integration partner. Used internally to reference this integration.
      - `user` IdentityUser, required — The user (company manager) associated with the current authentication token. Represents the person who authorized access to the company's data.
        - `email` string, required — The email address of the user who authorized the token.
        - `id` string, required — The unique identifier (UUID) of the user.
        - `name` string, required — The full name of the user who authorized the token.
        - `status` string, required — The current account status of the user on the Remote platform.
  - object — Returned when the current token is a Customer API Token. These tokens are used by companies accessing their own data directly (not through an integration partner), so only company and user information is included — there are no integration credentials.
    - `data` object, required
      - `company` IdentityCompany, required — The company that the current authentication token is scoped to. Only present when using a company-scoped access token or customer API token.
        - `id` string, required — The unique identifier (UUID) of the company. Use this ID when making subsequent API calls that require a company reference.
        - `name` string, required — The registered name of the company on the Remote platform.
      - `user` IdentityUser, required — The user (company manager) associated with the current authentication token. Represents the person who authorized access to the company's data.
        - `email` string, required — The email address of the user who authorized the token.
        - `id` string, required — The unique identifier (UUID) of the user.
        - `name` string, required — The full name of the user who authorized the token.
        - `status` string, required — The current account status of the user on the Remote platform.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `429` — Too many requests

---

[API](https://skmtc.net/remote-com/apis/remote.md) · [All operations](https://skmtc.net/remote-com/apis/remote/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/remote-com/remote/revisions/7e6a0c61ac82/schema)