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

# List Cards

`GET /api/v1/cards/`

## Request

- Base URL: `https://kokofinance.net` (the document declares no server; this is the origin it was published from)
- URL: `https://kokofinance.net/api/v1/cards/`
- Auth: API key in header `X-API-Key`

List credit cards with filtering, sorting, and pagination.

Returns lightweight card objects suitable for catalog browsing.
Use GET /{card_id} for the full enriched object.

## Query parameters

- `q` string, nullable: Fuzzy search across card name, issuer, and best_for
- `issuer` string, nullable: Filter by issuer (e.g. 'Chase')
- `card_type` string, nullable: Filter by card type (e.g. 'Travel Rewards')
- `tag` string, nullable: Filter by tag (e.g. 'premium', 'no_foreign_fee')
- `max_annual_fee` integer, nullable: Maximum annual fee in dollars
- `network` string, nullable: Filter by network (Visa, Mastercard, Amex, Discover)
- `country` string, nullable: ISO 3166-1 alpha-2 country code (e.g. 'US', 'GB'). Defaults to 'US'.
- `offset` integer: Offset for pagination
- `limit` integer: Number of results per page (max 100)
- `sort_by` string: Sort field
- `sort_order` string: Sort direction
- `cursor` string, nullable: Opaque cursor (takes precedence over offset)

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- APIResponse
  - `success` boolean, required
  - `data` unknown, required
  - `metadata` APIMetadata
    - `request_id` string
    - `api_version` string
    - `latency_ms` integer, nullable
    - `mode` string, nullable: Endpoint mode: 'fast' (deterministic, <100ms) or 'verbose' (includes AI narrative, 3-5s)
    - `timestamp` string
  - `error` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kokofinance/apis/koko-finance-api.md) · [All operations](https://skmtc.dev/kokofinance/apis/koko-finance-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kokofinance/apis/koko-finance-api/revisions/a5f1170af4d4?raw)