WalletD developers
Idempotency

Read the stored result of a completed idempotency key

Answers whether a keyed mutation already committed, without running anything.

GET/v1/ledgers/{ledgerId}/idempotency/{key}

Answers whether a keyed mutation already committed, without running anything. A caller whose own transaction died after the mutation committed here probes this before re-deriving anything from mutable state: found means the money already moved and the stored response is the truth to repair from. Not found is idempotency_key_not_found (404) and is authoritative within the 30-day retention window: the keyed mutation never committed. No request hash is compared, because a caller repairing after a crash may no longer be able to reproduce the request body it sent.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

ledgerId*string
Formatuuid
key*string
Length1 <= length <= 255

Response Body

application/json

application/problem+json

curl -X GET "https://example.com/v1/ledgers/497f6eca-6276-4993-bfeb-53cbbbba6f08/idempotency/string"
{  "status_code": 0,  "response": null}