Prepare claim

Asks us to prepare a new claim for a claimable order and returns 202 with no body. No request body. This call does not claim the funds. The new claim arrives a few seconds later in an orderUpdated webhook and on GET:

• A self-held wallet gets claimInstructions.preparedTransaction. The customer signs and submits its transaction before expiresAt.
• An embedded wallet gets the order’s authorization with reason claim. The key holder approves it.

Each call prepares a new claim and replaces the one before it. Call it right before the customer claims, because a claim goes stale when the wallet sends another transaction.

POST /organization/{organizationId}/order/{id}/claim

Prepare claim

cURL

curl --request POST \
  --url https://api.sand.etherfuse.com/organization/{organizationId}/order/{id}/claim \
  --header 'Authorization: <api-key>'

400

{
  "type": "https://docs.etherfuse.com/ramp/v2/errors/quote-expired",
  "title": "Quote expired",
  "status": 400,
  "detail": "quote 5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b has expired or does not exist",
  "instance": "tag:etherfuse.com,2026-08-28:R2-10120/0b1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d",
  "errors": [
    {
      "pointer": "#/accountDetails/clabe",
      "detail": "This field is required."
    }
  ],
  "required": [
    "<string>"
  ],
  "missing": [
    "<string>"
  ]
}

Authorizations

Authorization · string · header · required

API key sent in the Authorization header, with no Bearer prefix.

Path Parameters

organizationId · string<uuid> · required

The organization this call acts for: your API key's organization or one of its customer organizations. Any other id returns 404 not-found.

id · string<uuid> · required

The order id, which is the quoteId it was created from.

Response

202

We asked for a new claim. Empty body. Read the order, or wait for orderUpdated, to get it.