Cards

Search for credit cards

Search the card database using structured filters. Returns ranked results based on spending alignment, fee value, and sign-on bonus. Deterministic ranking, <100ms.

post/api/v1/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/cards/search
Auth: API key in header X-API-Key

Headers

authorizationstring nullable

Request body

card_typestring nullable

Card type filter: travel, cashback, balance_transfer, business, student, hotel, airline

max_annual_feeinteger nullable

Maximum annual fee in dollars (e.g. 200). Omit for no limit.

issuerstring nullable

Filter by issuer (e.g. 'Chase', 'American Express', 'Capital One')

spendingobject nullable

Monthly spending by category for ranking (e.g. {"dining": 500, "travel": 300})

max_resultsinteger nullable

Maximum number of results (1-20, default 5)

countrystring nullable

ISO 3166-1 alpha-2 country code (e.g. 'US', 'GB'). Defaults to 'US'.

Example request

{
  "card_type": "travel",
  "country": "US",
  "max_annual_fee": 300,
  "max_results": 5,
  "spending": {
    "dining": 500,
    "groceries": 300,
    "travel": 400
  }
}

Response

Ranked card recommendations matching filters

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.