---
title: "Retrieve CCIP token information"
method: GET
path: "/tokens"
tags: ["tokens"]
---

# Retrieve CCIP token information

`GET /tokens`

Returns information about Cross-Chain Interoperability Protocol (CCIP) supported tokens. The response includes token details organized by token symbol, with chain-specific information nested under each token and indexed by chain ID or selector (depending on the outputKey parameter).

## Query parameters

- `environment` 'mainnet' | 'testnet', required
- `token_id` string
- `chain_id` string
- `outputKey` 'chainId' | 'selector' | 'internalId'

## Response `200`

Successful response with token data

- TokenApiResponse
  - `metadata` TokenMetadata, required
    - `environment` 'mainnet' | 'testnet', required — The network environment
    - `timestamp` string, date-time, required — ISO timestamp of the response
    - `requestId` string, uuid, required — Unique identifier for the request
    - `ignoredTokenCount` integer, required — Number of tokens ignored due to configuration issues
    - `validTokenCount` integer, required — Number of valid tokens in the response
  - `data` object, required — Token data indexed by token symbol and then by chain ID/selector
  - `ignored` TokenConfigError[], required — List of tokens that were ignored due to configuration issues
    - `symbol` string, required — Token symbol
    - `reason` string, required — Reason for the configuration error
    - `missingFields` string[], required — List of missing required fields

## Other responses

- `400` — Invalid request parameters
- `500` — Internal server error

## Changes

- **2026-02-17** (v1) `7c63886b61d0` — 2 info
  - added the optional property `requestId` to the response with the `400` status
  - added the optional property `requestId` to the response with the `500` status
- **2025-05-19** (v1) `f253da0873ba` — 1 breaking, 2 info
  - response property `data/additionalProperties/additionalProperties/chainId` list-of-types was widened by adding types `string` to media type `application/json` of response `200`
  - the `data/additionalProperties/additionalProperties/poolAddress` response's property pattern `^0x[a-fA-F0-9]{40}$` was removed for the status `200`
  - the `data/additionalProperties/additionalProperties/tokenAddress` response's property pattern `^0x[a-fA-F0-9]{40}$` was removed for the status `200`
- **2025-03-28** (v1) `22e067b75eaa` — 1 info
  - endpoint added
- **2025-02-07** (v1) `1b317d8c0cde` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/smartcontractkit/apis/ccip-directory-and-configuration-rest-api-v1/changes/tokens/get.md)

---

[API](https://skmtc.dev/smartcontractkit/apis/ccip-directory-and-configuration-rest-api-v1.md) · [All operations](https://skmtc.dev/smartcontractkit/apis/ccip-directory-and-configuration-rest-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smartcontractkit/ccip-directory-and-configuration-rest-api-v1/revisions/313422bcca1a/schema)