---
title: "Report card balances"
method: POST
path: "/cards/balance-reports"
tags: ["Card"]
---

# Report card balances

`POST /cards/balance-reports`

Reports the current available balance for one or more real-time-auth cards. Balances are recorded as snapshots (the latest value per card wins) and are record-only. The batch is accepted asynchronously and returns a requestId to poll for the result.

## Headers

- `Accept-Version` string, required — Specifies the API version to use for this request.

## Request body

- object
  - `requestId` string, uuid, required
  - `reports` object[], required
    - `cardId` string, uuid, required
    - `availableBalance` string, required
    - `timestamp` string, date-time, required

## Response `202`

Accepted for asynchronous processing

- object
  - `requestId` string, uuid — Echoes the client-supplied idempotency key
  - `status` 'PENDING'
  - `itemCount` number, float — Number of reports accepted
  - `statusUrl` string — Relative URL to poll for status

## Other responses

- `400` — Invalid inputs
- `409` — The requestId was reused with a different payload, or belongs to another business. Same-payload retries are idempotent and return the existing status.

---

[API](https://skmtc.net/reap-global/apis/reap-api.md) · [All operations](https://skmtc.net/reap-global/apis/reap-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reap-global/reap-api/revisions/525072733e02/schema)