Retrieve a transfer reversal
Retrieve a single reversal. Returns 404 if the reversal does not belong to the transfer
in the path.
Authorization
X-API-Key X-Publishable-Key Your Bolt API key, from Developer > API in the Bolt Merchant Dashboard. Server-side only.
Sandbox keys work only against api-sandbox.boltapp.com. Using a sandbox key against
production, or the reverse, returns 401.
In: header
The publicly shareable identifier for your merchant division. Your authenticated account is always one side of a transfer, and seller IDs are resolved against it.
In: header
Path Parameters
The ID of the transfer to operate on.
The ID of the reversal to operate on.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v3/transfers/trf_9f8e7d6c5b/reversals/trr_4a3b2c1d0e"{ "id": "trr_4a3b2c1d0e", "created_at": "2026-10-20T11:02:44Z", "transfer_id": "trf_9f8e7d6c5b", "status": "pending", "amount": { "currency": "USD", "units": 4000 }, "reference": "reversal-return-8831", "description": "Partial return, 1 of 3 items", "payout_reference": "po_20261021_0044", "metadata": { "invoice": "INV-2026-0114" }}Create a transfer reversal POST
Move the funds back the way they came. Partial reversals are allowed, repeatedly, up to the transfer's unreversed remainder. Once a transfer is fully reversed it cannot be reversed again. Only `paid` transfers can be reversed. Before that the money has not arrived, so cancel the transfer instead. A `failed` transfer has nothing to reverse: the funds were already returned.
Update a transfer reversal PATCH
Update a reversal's `description` or `metadata`. The amount cannot be changed. Send only the fields you want to change.