---
title: "Get cards"
method: GET
path: "/cards"
tags: ["Cards"]
---

# Get cards

`GET /cards`

## Request

- Base URL: `https://api.truelayer-sandbox.com/data/v1`
- URL: `https://api.truelayer-sandbox.com/data/v1/cards`
- Auth: OAuth 2
  - Authorization code: `https://auth.truelayer.com/token/connect`
  - Token URL: `https://auth.truelayer.com/token/connect` scopes: `cards`

List all cards

## Query parameters

- `async` 'true'
- `webhook_uri` string, uri

## Headers

- `X-Client-Correlation-Id` string
- `X-PSU-IP` string

## Response `200`

OK

- object
  - `results` Card[]
    - `account_id` string: Unique identifier of the account
    - `card_network` string
    - `card_type` string
    - `currency` 'EUR' | 'GBP' | 'USD' | 'AUD': Currency used for this account or transaction
    - `display_name` string
    - `partial_card_number` string
    - `name_on_card` string
    - `valid_from` string
    - `valid_to` string
    - `update_timestamp` string
    - `provider` object
      - `provider_id` string
  - `status` 'Succeeded' | 'Queued' | 'Running' | 'Failed': Indicates whether the request was successful. 'Queued', 'Running' and 'Failed' can be returned for async requests.

## Other responses

- `202`: Accepted
- `401`: Unauthorized
- `403`: Access denied
- `404`: Not found
- `429`: Rate limit exceeded
- `500`: Internal server error
- `501`: Not implemented
- `503`: Service unavailable
- `504`: Gateway timeout

---

[API](https://skmtc.dev/truelayer/apis/data-api-v1.md) - [All operations](https://skmtc.dev/truelayer/apis/data-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/truelayer/apis/data-api-v1/revisions/2906fd6d5b2a?raw)