International

Market Search Cards

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.

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

Path parameters

countrystring required

ISO 3166-1 alpha-2 country code

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

Successful Response

unknown required

Changes

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