API ReferenceWallet

Preview withdrawal routing

How a withdrawal of this amount would be split across rails under the closed-loop return-to-source policy. Read-only: nothing is reserved, nothing is charged, no compliance control runs.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

OR
X-API-Keystring

Server-side API key (drzl_live_ prefix), least-privilege scoped. Keep it secret — never ship it to a browser or SPA. An alternative to a session JWT (HTTPBearer) on the developer surface. See docs/api/cors-and-auth.md.

Headers

X-API-Keystring or nullOptional

Query parameters

amountdouble or stringRequired
destination_idstring or nullOptionalformat: "uuid"

Response

Successful Response
amountstringformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"
The gross amount previewed, in CAD.
enabledboolean

Whether closed-loop routing applies at all.

feestringformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"
Withdrawal fee that would apply, in CAD.
instantobject

MR-26: the instant-tier offer for this amount.

net_amountstringformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"

Amount actually routed (gross − fee), in CAD.

returned_to_sourcestringformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"
Total routed back to funding sources.
to_destinationstringformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"
Total routed to the verified destination.
legslist of objects
The split, in execution order.

Errors

401
Unauthorized Error
403
Forbidden Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error