curl https://api.liddie.io/api/v1/payments/refunds/<refundId> \
-H "Authorization: Bearer lid_live_..."
const response = await fetch('https://api.liddie.io/api/v1/payments/refunds/<refundId>', {
headers: { 'Authorization': 'Bearer lid_live_...' },
});
const { ok, data } = await response.json();
{
"status": "<string>",
"txHash": "<string>"
}Refunds
Get a refund
Poll a single Liddie refund by id to track its status from pending to refunded — with the on-chain txHash — or to failed if the payout could not be sent.
GET
/
api
/
v1
/
payments
/
refunds
/
{refundId}
curl https://api.liddie.io/api/v1/payments/refunds/<refundId> \
-H "Authorization: Bearer lid_live_..."
const response = await fetch('https://api.liddie.io/api/v1/payments/refunds/<refundId>', {
headers: { 'Authorization': 'Bearer lid_live_...' },
});
const { ok, data } = await response.json();
{
"status": "<string>",
"txHash": "<string>"
}Fetches one refund by its ID. Use it to follow a refund after you create it: the status advances
pending → refunded (plus txHash once verified on-chain) or failed.
curl https://api.liddie.io/api/v1/payments/refunds/<refundId> \
-H "Authorization: Bearer lid_live_..."
const response = await fetch('https://api.liddie.io/api/v1/payments/refunds/<refundId>', {
headers: { 'Authorization': 'Bearer lid_live_...' },
});
const { ok, data } = await response.json();
Authorization
API key scoperefunds:read or dashboard JWT with team permission refunds:view. Rate limit 60/min.
Parameters
string
required
ID of the refund, as returned by Create a refund.
Poll this endpoint after Create a refund until
status leaves pending — txHash appears once the refund transaction is verified on-chain.Response
string
Advances
pending → refunded or failed.string
Present once the refund transaction is verified on-chain.
See also
- Create a refund: the call that returns the
refundIdpolled here. - List refunds for a payment: full refund history plus the remaining-refundable amount.
- Route map: every refund endpoint at a glance.