---
title: "Market Search Cards"
method: POST
path: "/api/v1/{country}/cards/search"
tags: ["International"]
---

# Market Search Cards

`POST /api/v1/{country}/cards/search`

## 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/{country}/cards/search`
- Auth: API key in header `X-API-Key`

Search for credit cards in this market.

Same as POST /api/v1/cards/search but the market is specified in the
URL path. The country field in the request body is overridden by the
path value.

## Path parameters

- `country` string, required: ISO 3166-1 alpha-2 country code

## Headers

- `authorization` string, nullable

## Request body

- V1CardSearchRequest: Request for POST /search
  - `card_type` string, nullable: Card type filter: travel, cashback, balance_transfer, business, student, hotel, airline
  - `max_annual_fee` integer, nullable: Maximum annual fee in dollars (e.g. 200). Omit for no limit.
  - `issuer` string, nullable: Filter by issuer (e.g. 'Chase', 'American Express', 'Capital One')
  - `spending` object, nullable: Monthly spending by category for ranking (e.g. {"dining": 500, "travel": 300})
  - `max_results` integer, nullable: Maximum number of results (1-20, default 5)
  - `country` string, nullable: ISO 3166-1 alpha-2 country code (e.g. 'US', 'GB'). Defaults to 'US'.

## Response `200`

Successful Response

- unknown

## 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)