Intelligence

Recommend Cards

Get card recommendations for a spending category.

fast mode: Mode A (portfolio_card_names provided): Ranks portfolio cards by reward value for the requested category. No AI narrative. Mode B (no portfolio_card_names): Ranks market cards by net value.

verbose mode: Mode A: Returns AI-generated headline, explanation, pro_tip, and alternative card narratives. Mode B: Same as fast (already deterministic, no AI needed).

post/api/v1/intelligence/recommend

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/intelligence/recommend
Auth: API key in header X-API-Key

Query parameters

mode'fast' | 'verbose'

Response mode for intelligence endpoints.

fast=deterministic <100ms, verbose=AI narrative 2-4s

Headers

authorizationstring nullable

Request body

categorystring required

Spending category: dining, travel, groceries, gas, etc.

amountnumber nullable

Monthly spend amount for this category

portfolio_card_namesstring[] nullable

If provided, recommend from portfolio instead of market

Example request

{
  "category": "dining",
  "params": {
    "credit_tier": "excellent",
    "primary_goal": "cashback",
    "spending": {
      "dining": 600,
      "groceries": 400
    }
  }
}

Response

Successful Response

unknown required

Changes

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