Cancel a held quote so it prices nothing

POST/fx-quotes/{id}/cancel

Initiate permission on the source account. A held quote is withdrawn and prices nothing; cancelling an already cancelled quote answers the same again. A booked quote is a firm rate and is not cancellable: it runs to its conversion or its expiry (409).

Path parameters

idstringRequired

Headers

Idempotency-KeystringOptional

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Returns

200 OK

The FX Quote object.

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503

Request

curl -X POST 'https://api.dev.bank.corgi.com/fx-quotes/{id}/cancel' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)"

Response200

{
  "base_amount": 10000,
  "booked_at": "2026-09-17T14:30:00Z",
  "cancelled_at": "2026-09-17T14:30:00Z",
  "created_at": "2026-09-17T14:30:00Z",
  "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "expired_at": "2026-09-17T14:30:00Z",
  "expires_at": "2026-09-17T14:30:00Z",
  "id": "string",
  "pair": "string",
  "quote_amount": 10000,
  "rate": "string",
  "rate_sheet_id": "string",
  "side": "string",
  "source_account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "source_amount": 10000,
  "source_currency": "string",
  "state": "string",
  "target_account_id": "acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "target_amount": 10000,
  "target_currency": "string"
}