---
title: "Merchant Benefits"
method: POST
path: "/api/v1/intelligence/merchant/benefits"
tags: ["Intelligence"]
---

# Merchant Benefits

`POST /api/v1/intelligence/merchant/benefits`

## 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/merchant/benefits`
- Auth: API key in header `X-API-Key`

Check if any of your cards have credits or benefits at a specific merchant.

Also includes an earning recommendation (which card earns most here).

## Headers

- `authorization` string, nullable

## Request body

- MerchantBenefitsRequest: Request for POST /api/v1/intelligence/merchant/benefits
  - `merchant` string, required: Merchant name (e.g. 'Saks Fifth Avenue', 'Uber')
  - `portfolio` string[], required: List of card names in user's portfolio

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