curl -H "Authorization: Bearer lid_live_..." \
"https://api.liddie.io/api/v1/conversions?page=1&limit=50"
const res = await fetch('https://api.liddie.io/api/v1/conversions?page=1&limit=50', {
headers: { Authorization: 'Bearer lid_live_...' }
})
const { items, total } = await res.json()
{ "items": [ { "...": "conversion records" } ], "total": 137 }
Conversions
List conversions
List your conversion history with offset pagination in the Liddie API — review past currency swaps, statuses, and credited amounts.
GET
/
api
/
v1
/
conversions
curl -H "Authorization: Bearer lid_live_..." \
"https://api.liddie.io/api/v1/conversions?page=1&limit=50"
const res = await fetch('https://api.liddie.io/api/v1/conversions?page=1&limit=50', {
headers: { Authorization: 'Bearer lid_live_...' }
})
const { items, total } = await res.json()
{ "items": [ { "...": "conversion records" } ], "total": 137 }
Returns your conversion history, offset-paginated. History reads keep working even while conversions are disabled platform-wide.
Authorization
Dual auth — a secret API key with theconversions:read scope, or a dashboard JWT with the conversions:view permission. Dashboard sessions must belong to a merchant_admin, merchant_member or super_admin role; API-key callers are gated by scope only. See the Authentication guide.
Rate limit: the global default.
curl -H "Authorization: Bearer lid_live_..." \
"https://api.liddie.io/api/v1/conversions?page=1&limit=50"
const res = await fetch('https://api.liddie.io/api/v1/conversions?page=1&limit=50', {
headers: { Authorization: 'Bearer lid_live_...' }
})
const { items, total } = await res.json()
{ "items": [ { "...": "conversion records" } ], "total": 137 }
When rendering rows, remember that
toAmount, exchangeRate, commissionRate, commissionAmount and netFromAmount can be absent on conversions that ended before a quote existed — render — (or merchantMessage), never substitute 0, which would read as a free conversion or a zero rate.Query parameters
integer
Page number (offset pagination).
integer
Page size. Default 50, max 100.
Response fields
array
Conversion records — see the full field list in Conversion record fields. Note that
toAmount, exchangeRate, commissionRate, commissionAmount and netFromAmount are optional and absent on any conversion that ended before a quote ever existed — render — (or merchantMessage) when a field is missing, never substitute 0.number
Total number of conversions for the merchant.
Errors
| Status | Body | Why |
|---|---|---|
| 400 | { "ok": false, "error": { "code": "NO_MERCHANT_CONTEXT", "message": "…" } } | No merchant context on the credential. |
See also
- Get a conversion: fetch one record — the status source of truth for polling.
- Execute a conversion: the full conversion record field list lives there.
- Conversions Overview: status lifecycle and the shared error envelope.