---
title: "Save Balances"
method: POST
path: "/api/v1/portfolio/points/balances"
tags: ["Portfolio"]
---

# Save Balances

`POST /api/v1/portfolio/points/balances`

## 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/portfolio/points/balances`
- Auth: none declared

Batch upsert point balances.

## Headers

- `authorization` string, nullable
- `X-Guest-ID` string, nullable

## Request body

- SaveBalancesRequest: Request for POST /api/v1/points/balances — batch upsert
  - `balances` SaveBalanceItem[], required: Balances to save
    - `program_key` string, required: Program key
    - `balance` integer, required: Point/miles balance
    - `expiration_date` string, nullable: Expiration date (YYYY-MM-DD) if applicable
    - `program_name` string, nullable: Program name (for free-text entries not in our system)

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