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

# List cards

`GET /v2/cards`

Lists all cards by a `user_id`.
Only cards with `limit_type = CARD` have `spend_controls`

## Query parameters

- `user_id` string, nullable
- `cursor` string, nullable
- `limit` integer, nullable

## Response `200`

listCardsByUserId 200 response

- PageCard
  - `next_cursor` string, nullable
  - `items` Card[], required — unresolved $ref

## Changes

- **2026-08-11** `58e231ca118e` — 2 breaking, 2 info
  - the response property `items/items/card_name` became nullable for the status `200`
  - the response property `items/items/card_name` became optional for the status `200`
  - added the optional property `items/items/partner` to the response with the `200` status
  - added the required property `items/items/created_at` to the response with the `200` status

[Change history](https://skmtc.dev/brex-com/apis/team-api/changes/v2/cards/get.md)

---

[API](https://skmtc.dev/brex-com/apis/team-api.md) · [All operations](https://skmtc.dev/brex-com/apis/team-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brex-com/team-api/revisions/58e231ca118e/schema)