---
title: "Get current token identity"
method: GET
path: "/api/v2/identity/token"
tags: ["API User Identities"]
---

# Get current token identity

`GET /api/v2/identity/token`

## Request

- Base URL: `https://api.starlingbank.com`
- URL: `https://api.starlingbank.com/api/v2/identity/token`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/starlingbank/apis/starling-bank-api/docs/api/v2/identity/token/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint returns the permissions you have access to, the time until the token expires and the account holder's unique identifier.

## Response `200`

Successful operation

- IdentityV2
  - `accountHolderUid` string, uuid
  - `expiresAt` string, date-time
  - `expiresInSeconds` integer
  - `scopes` string[]: The scopes which this token has permission to use e.g. balance:read
  - `authenticated` boolean
  - `applicationUserUid` string, uuid
  - `consentExpiresAt` string, date-time
  - `customerUid` string, uuid: Deprecated, use accountHolderUid instead

## Other responses

- `4xx`: Client error. See [API status codes](#api-status-codes-1) for more details.
- `5xx`: Server error. See [API status codes](#api-status-codes-1) for more details.

---

[API](https://skmtc.dev/starlingbank/apis/starling-bank-api.md) - [All operations](https://skmtc.dev/starlingbank/apis/starling-bank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starlingbank/apis/starling-bank-api/revisions/7c5075cfbe63?raw)