---
title: "Trigger a card data refresh"
method: POST
path: "/refresh-card-data"
---

# Trigger a card data refresh

`POST /refresh-card-data`

## Request

- Base URL: `https://laso.finance`
- URL: `https://laso.finance/refresh-card-data`
- Auth: API key in header `Authorization`

Requests an updated balance for a card.

For U.S. non-reloadable cards (default), the card is re-scraped from the issuer via a retrieval queue and processed asynchronously. Rate limited per card to one request every 5 minutes, and to at most 12 refreshes in any rolling 24-hour period.

For international non-reloadable cards, a balance update request is recorded; an admin will manually update the balance within 24 hours. While a balance update is already pending for a card, additional requests for that card return 409.

Requires a Bearer token from `/auth` or `/get-card`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `card_id` string, required: The card ID to refresh data for
  - `card_type` 'Non-Reloadable U.S.' | 'Non-Reloadable International': The type of card. Defaults to `Non-Reloadable U.S.` if omitted.

## Response `200`

Card refresh requested successfully

- object
  - `success` boolean
  - `message` string

## Other responses

- `400`: Missing card_id
- `401`: Missing or invalid Bearer token
- `403`: Account is frozen. The response includes a `frozen_message` field explaining why.
- `404`: Card not found
- `409`: Card already has a pending refresh/balance update request
- `422`: The `Idempotency-Key` was already used for a different request body or route (`code: idempotency_key_reused`). Use a new key.
- `429`: Rate limited — either less than 5 minutes since the last refresh of this card, or this card has reached its 24-refresh daily limit. Both limits are per card. `Retry-After` and `retry_after_seconds` give the exact wait.

---

[API](https://skmtc.dev/laso/apis/laso-finance-x402-api.md) · [All operations](https://skmtc.dev/laso/apis/laso-finance-x402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/laso/apis/laso-finance-x402-api/revisions/ff8ce20b49ba?raw)