Trigger a card data refresh

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.

post/refresh-card-data

Request

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

Headers

Idempotency-Keystring

Optional client-generated unique key (a UUID works) that makes this write safe to retry. A retry with the same key within 24 hours returns the recorded response of the original request, marked with an Idempotency-Replayed: true header, instead of performing the write again. Reusing a key with a different body or route is rejected with 422 (code: idempotency_key_reused); a retry that arrives while the original is still running gets 409 (code: idempotency_key_in_progress), so wait a moment and retry with the same key. Keys are scoped to the authenticated account.

Request body

card_idstring 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

Card refresh requested successfully

successboolean
messagestring

Example response

{
  "message": "Card refresh requested."
}

Changes

No recorded changes to this operation across all 3 revisions of this API.