Sub-Accounts
Cancel an allocation
Reverse a single allocation, returning the funds to the source wallet. Kiotapay checks the destination wallet still holds enough to reverse before proceeding.
Note this is a GET even though it changes state — that is how the API is built, so take care not to place it behind anything that prefetches links.
Authorization
bearerAuth AuthorizationBearer <token>
The access_token returned by POST /api/v1/get-token.
In: header
Query Parameters
allocationId*string
UUID of the allocation to cancel — the requestId returned when it was created.
Format
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/sandbox/v1/allocations/single/cancel?allocationId=ade82d5a-4ab0-4d96-b855-b7f933336f97"{ "status": 200, "message": "SUCCESS", "data": "Allocation cancelled successfully"}