# View tokens

Use the tickers API to retrieve tokens by classification state. Ripple Custody uses an Allowlist-Only visibility model where tokens are filtered by their validation and lock status.

The Token Management feature uses the existing Tickers API. No new endpoints are required—classification is controlled through the `validationStatus` and `lock` query parameters.

## Prerequisites

Before retrieving tokens, you need the following:

| Prerequisite | Additional information |
|  --- | --- |
| API authentication | [Authentication](/products/custody/v1.34/api/authentication) |


## Get allowlisted tokens

To retrieve tokens that are approved and visible in the UI:


```http
GET /v1/tickers?validationStatus=Validated&lock=Unlocked
```

See [List tickers](https://docs.ripple.com/products/custody/api/reference/openapi/tickers/gettickers) for the complete API reference.

## Get unclassified tokens

To retrieve tokens that have not been reviewed:


```http
GET /v1/tickers?validationStatus=NonValidated&lock=Unlocked
```

## Get denylisted tokens

To retrieve tokens that have been blocked:


```http
GET /v1/tickers?validationStatus=Validated&lock=Locked
```

## Get a single token

To retrieve details for a specific token by ID:


```http
GET /v1/tickers/{tickerId}
```

See [Get ticker](https://docs.ripple.com/products/custody/api/reference/openapi/tickers/getticker) for the complete API reference.

## Query parameters

The following parameters filter the token list. For the complete parameter reference, see [List tickers](https://docs.ripple.com/products/custody/api/reference/openapi/tickers/gettickers).

| Parameter | Type | Values | Description |
|  --- | --- | --- | --- |
| `validationStatus` | string | `Validated`, `NonValidated` | Filter by validation status |
| `lock` | string array | `Locked`, `Unlocked`, `Archived` | Filter by lock status |
| `ledgerId` | string array | — | Filter by ledger ID |
| `kind` | string | `Native`, `Contract` | Filter by token kind |
| `name` | string array | — | Filter by token name (partial match) |
| `symbol` | string array | — | Filter by token symbol (partial match) |
| `limit` | integer | 1-100 | Number of results to return |
| `startingAfter` | UUID | — | Pagination cursor |
| `sortBy` | string | `id`, `ledgerId`, `kind`, `name`, `symbol` | Sort field |
| `sortOrder` | string | `Asc`, `Desc` | Sort direction |


## Response example


```json
{
  "items": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "ledgerId": "ethereum-mainnet",
      "kind": "Contract",
      "name": "USD Coin",
      "symbol": "USDC",
      "decimals": 6,
      "validationStatus": "Validated",
      "lock": "Unlocked",
      "ledgerDetails": {
        "properties": {
          "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
          "type": "ERC20"
        }
      }
    }
  ],
  "pageInfo": {
    "hasNextPage": false
  }
}
```

## Response fields

| Field | Type | Description |
|  --- | --- | --- |
| `id` | UUID | Unique token identifier |
| `ledgerId` | string | Blockchain network identifier |
| `kind` | string | `Native` for native tokens, `Contract` for smart contract tokens |
| `name` | string | Token display name |
| `symbol` | string | Token ticker symbol |
| `decimals` | integer | Decimal precision for the token |
| `validationStatus` | string | `Validated` or `NonValidated` |
| `lock` | string | `Locked`, `Unlocked`, or `Archived` |
| `ledgerDetails` | object | Ledger-specific token properties |


## Related topics

- [Token Management concepts](/products/custody/v1.34/concepts/token-management)
- [Allowlist tokens](/products/custody/v1.34/api/accounting-entities/token-management/allowlist)
- [Denylist tokens](/products/custody/v1.34/api/accounting-entities/token-management/denylist)
- [Restore tokens](/products/custody/v1.34/api/accounting-entities/token-management/restore)
- [API reference: List tickers](https://docs.ripple.com/products/custody/api/reference/openapi/tickers/gettickers)
- [API reference: Get ticker](https://docs.ripple.com/products/custody/api/reference/openapi/tickers/getticker)