Simulation

Simulate card status

POSThttps://api.firstleeward.com/v0/simulation/cards/:id/status

Simulates a card status change. ACTIVE unfreezes a frozen or blocked card. FROZEN freezes an active card. BLOCKED blocks an active or frozen card. EXPIRED expires a card.

Authorizations

Authorizationstring · headerrequired

API key as Bearer token, e.g. Bearer YOUR_API_KEY

Headers

Leeward-Versionenum<string>required

API version (YYYY-MM-DD). Available option: 2026-09-18

Path Parameters

idstring<uuid>required

Body

application/json

statusstringrequired

Target card status

Available options:ACTIVEFROZENBLOCKEDEXPIRED

blockReasonstring

Reason to block with, allowed only when status is BLOCKED. Defaults to SUSPECTED_FRAUD_PIN, which the unblock endpoint can lift; pass OTHER to produce a block that only First Leeward support can lift. CLIENT_REQUESTED is not offered here - block the card through POST /cards/{id}/block to get it.

Available options:SUSPECTED_FRAUD_CVVSUSPECTED_FRAUD_EXPIRYSUSPECTED_FRAUD_PINFRAUD_ALERT_CONFIRMEDOTHER

Response

204Response for status 204

400The resource is not in a valid state for the requested simulation

errorobjectrequired

Show child attributes

codestringrequired

messagestringrequired

detailobject | nullrequired