Retrieve a simulated-spend attempt
/v1/simulated-spends/{id}Requires an API client bearer token.
Fetch the queryable record of one simulated-spend attempt by id (tenant-scoped). Reports the full lifecycle — accepted, sent, decided, stood in, or failed — so a failed or slow attempt is distinguishable from one that never happened.
Parameters
Path parameters
| Name | Required | Description |
|---|---|---|
| id | required |
Example
curl https://api.rigid.fi/v1/simulated-spends/{id} \
-H "Authorization: Bearer $RIGID_API_TOKEN"Responses
200The simulation record.
+ show properties− hide properties
+ show properties− hide properties
Sandbox WIRE vocabulary, derived from the simulated DE39 response code alone — NOT the closed decline-reason contract that transactions and webhooks publish. Tokens are the standard ISO 8583 meanings of the code (do_not_honor, lost_card, stolen_card, insufficient_funds, not_permitted_to_cardholder, ...), with an unrecognised code reported as declined_<code>. Several published decline reasons share one wire token (mcc_denied and entry_mode_denied both ride DE39 57, so both appear here as not_permitted_to_cardholder), and the spellings near-miss across the two surfaces (wire lost_card vs published card_lost) — so never match these tokens against the published vocabulary. Read the published reason from the transaction or the authorization.decided event. See the Decline reasons guide.
400Validation error
401Authentication required
403Forbidden
404Simulation not found
500Internal server error