get
https://partner.gupshup.io/partner//auth/tokens
Lists Universal Tokens for the partner (active, expired, and revoked), newest first.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Description
- Optionally filter by status and/or name.
- Filters are optional and combinable (status AND name).
- Raw JWTs are never returned.
Rate limit
30 requests / 60 seconds.
API Request
with filters
curl --location --request GET 'https://partner.gupshup.io/partner/{{PARTNER_ID}}/auth/tokens?status=ACTIVE&name=prod' \
--header 'Authorization: Bearer {{UNIVERSAL_TOKEN}}'without filters
curl --location --request GET 'https://partner.gupshup.io/partner/{{PARTNER_ID}}/auth/tokens' \
--header 'Authorization: Bearer {{UNIVERSAL_TOKEN}}'Response
| Status Code | Response | Comments |
|---|---|---|
| 200 | [ { "id": "row-id-789", "name": "prod-automation", "createdByEmail": "[email protected]", "createdOn": 1783053048000, "expiredOn": 1783939200000, "revokedOn": null, "status": "ACTIVE" } ] | Success. Body is a JSON array (not wrapped). status is ACTIVE, EXPIRED, or REVOKED. |
| 401 | { "status": "error", "message": "Unauthorised access to the resource. Please review request parameters and headers and retry" } | Missing/invalid authentication (JwtAuthenticationEntryPoint). |
| 403 | { "status": "error", "message": "Forbidden Access" } | Path partnerId does not match authenticated partner context (AuthPathValidator), or caller lacks PARTNER_ADMIN. |
| 429 | { "status": "error", "message": "Too Many Requests" } | More than 30 requests / 60 seconds. |
| 500 | { "status": "error", "message": "Internal server error. Please try again later and If Issue still persist then contact Gupshup Dev Support" } | Unexpected server failure. |
Request Parameters
| Key | Description | Values | Data Type | Required / Optional | Constraints |
|---|---|---|---|---|---|
| Headers | |||||
| Authorization | Caller credential | Bearer {{UNIVERSAL_TOKEN}} | String | Required | UT Bearer, Partner UI session, or Partner token with PARTNER_ADMIN. |
| Path | |||||
| partnerId | Partner ID | e.g. 8814 | Integer | Required | Must match authenticated partner context. |
| Query | |||||
| status | Status filter | ACTIVE, EXPIRED, REVOKED | String | Optional | Exact match (case-insensitive compare in filter). |
| name | Name filter | prod | String | Optional | Case-insensitive substring match on token name. |
Token Status
| Status | Meaning |
|---|---|
| ACTIVE | Not revoked and expiredOn is still in the future. |
| EXPIRED | Not revoked and expiredOn ≤ now (natural expiry). |
| REVOKED | revokedOn is set. Original expiredOn is preserved for inspection. |