Operation
List refund requests
GET
/refund-requestsLists refund and exchange requests the actor may see, optionally filtered by status. Each request carries the fields the caller's access tiers reach: refundrequests.read for the selling or the event-owning account shows every documented field, and refundrequests.list alone shows only public fields, which a request has none of.
Query parameters
statusstringOptional- Filter by request status
Returns
Refund requests retrieved successfully
Errors
- 400
- Bad Request - Invalid input
- 401
- Unauthorized - Authentication required
- 403
- Forbidden - Insufficient permissions
- 404
- Not Found - Resource not found
- 500
- Internal Server Error
Every error names its code and links to it. All error codes
curl -X GET "https://api.ticketlayer.com/v1/refund-requests" \ -H "Authorization: Bearer tlak_..." \ -H "X-Ticketlayer-Org: your-org-slug"Response 200
{
"requests": [
{
"id": "rfr_abc123",
"organisationId": "org_abc123",
"orderId": "ord_abc123",
"accountId": "acc_abc123",
"type": "refund",
"status": "pending",
"reason": "Customer cannot attend",
"refundTo": "original",
"notes": null,
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-15T10:30:00Z"
}
]
}