---
title: "List Universal App Tokens"
method: GET
path: "/partner/app/{appId}/tokens"
tags: ["Universal App Token"]
---

# List Universal App Tokens

`GET /partner/app/{appId}/tokens`

## Request

- Base URL: `https://partner.gupshup.io`
- URL: `https://partner.gupshup.io/partner/app/{appId}/tokens`
- Auth: API key in header `Authorization`

Lists all UATs ever minted for the app (active, expired, revoked), newest first.

## Path parameters

- `appId` string, uuid, required

## Query parameters

- `status` 'ACTIVE' | 'EXPIRED' | 'REVOKED': ACTIVE - not revoked and expiredOn is still in the future. EXPIRED - not revoked and expiredOn is less than or equal to now (natural expiry). REVOKED - revokedOn is set. Original expiredOn is preserved.
- `name` string

## Response `200`

Successful response. Tokens are wrapped under the tokens field.

- ListAppTokensSuccessResponse
  - `status` string
  - `tokens` AppTokenSummary[]: Matching tokens, newest first. Empty array when nothing matches.
    - `id` string: Token row id
    - `name` string: Token label
    - `createdByEmail` string, email: Partner admin who minted the token
    - `createdOn` integer: Mint time, epoch milliseconds
    - `expiredOn` integer: Expiry time, epoch milliseconds. Preserved even after revocation.
    - `revokedOn` integer, nullable: Revocation time, epoch milliseconds. Null when the token has not been revoked.
    - `status` 'ACTIVE' | 'EXPIRED' | 'REVOKED': ACTIVE - not revoked and expiredOn is still in the future. EXPIRED - not revoked and expiredOn is less than or equal to now (natural expiry). REVOKED - revokedOn is set. Original expiredOn is preserved.

## Other responses

- `400`: App not linked to the authenticated partner
- `401`: Unauthorized access - missing or invalid authentication (JwtAuthenticationEntryPoint)
- `429`: Rate limit exceeded - more than 30 requests / 60 seconds
- `500`: Internal server error - unexpected server failure

---

[API](https://skmtc.dev/gupshup/apis/universal-app-token-uat-apis.md) - [All operations](https://skmtc.dev/gupshup/apis/universal-app-token-uat-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/gupshup/apis/universal-app-token-uat-apis/revisions/e2c6e72dd1ea?raw)