curl "https://api.liddie.io/api/v1/withdrawals?page=1&limit=20&filter=all" \
-H "Cookie: <dashboard session cookies>"
// Dashboard-session auth: send the session JWT as a Bearer token
const params = new URLSearchParams({ page: '1', limit: '20', filter: 'all' })
const res = await fetch(`https://api.liddie.io/api/v1/withdrawals?${params}`, {
headers: { Authorization: `Bearer ${dashboardJwt}` },
})
const { ok, data } = await res.json()
{"ok":true,"data":{"items":[],"total":0}}
Withdrawals
List withdrawals
List your Liddie crypto withdrawal history with pagination, optionally including mass-payout legs via the filter query parameter for a full audit trail.
GET
/
api
/
v1
/
withdrawals
curl "https://api.liddie.io/api/v1/withdrawals?page=1&limit=20&filter=all" \
-H "Cookie: <dashboard session cookies>"
// Dashboard-session auth: send the session JWT as a Bearer token
const params = new URLSearchParams({ page: '1', limit: '20', filter: 'all' })
const res = await fetch(`https://api.liddie.io/api/v1/withdrawals?${params}`, {
headers: { Authorization: `Bearer ${dashboardJwt}` },
})
const { ok, data } = await res.json()
{"ok":true,"data":{"items":[],"total":0}}
Returns your withdrawal history, page by page — use
The example shows a merchant with no withdrawals yet.
filter=all to also include mass-payout legs.
curl "https://api.liddie.io/api/v1/withdrawals?page=1&limit=20&filter=all" \
-H "Cookie: <dashboard session cookies>"
// Dashboard-session auth: send the session JWT as a Bearer token
const params = new URLSearchParams({ page: '1', limit: '20', filter: 'all' })
const res = await fetch(`https://api.liddie.io/api/v1/withdrawals?${params}`, {
headers: { Authorization: `Bearer ${dashboardJwt}` },
})
const { ok, data } = await res.json()
{"ok":true,"data":{"items":[],"total":0}}
Authorization
Dashboard-only (JWT session). Roles:merchant_admin / merchant_member / super_admin, with team permission withdrawals:view. Rate limit: 60/min.
No API-key scope reaches this endpoint — calling it with an API key fails with 401 {"error":"Invalid or expired token"} (the key is not a JWT).
Parameters
integer
Page number to return, starting at
1. Defaults to 1.integer
Rows per page,
1–100. Defaults to 25.string
manual (default) returns only your own withdrawals; all also includes the per-recipient mass-payout legs.Response
| Field | Description |
|---|---|
ok | Success discriminator — true when the request succeeded. |
data.items | The withdrawal rows for the requested page. Empty array when the merchant has no withdrawals. |
data.total | Total number of withdrawal rows across all pages. |
Errors
| Status | Body | Why |
|---|---|---|
| 401 | {"error":"Invalid or expired token"} | Called with an API key (or an expired session) — this endpoint is dashboard-JWT only. |
See also
- Request a withdrawal: create the withdrawals that show up in this history.
- Get whitelist: the destination addresses withdrawals are allowed to pay out to.
- Authentication: how dashboard JWT sessions differ from API-key auth.