Report refunds

This endpoint is tailored for our Affiliate partners whose customers book via tiqets.com checkout flow. However, it is also accessible for API partners using the booking API but some fields might not be relevant or always empty. We recommend to our booking API partners to use the List orders endpoint described in the Booking API section

Retrieve list of refunds for the report

get

https://api.tiqets.com/v2https://api-tiqt-test.steq.it/v2https://api.api-tiqt-test.steq.it/v2

/reports/refunds

Query parameters

page_sizeinteger · min: 1 · max: 100Optional

Number of items per page. Default value is 10, maximum value is 100.

Default: 10Example: 5

pageinteger · min: 1Optional

Number of the page to retrieve. Used in combination with the page_size parameter to define the page size.

Default: 1Example: 1

start_datestring · dateOptional

Start day for which refunds were finalised. Defaults to 30 days after end_date

Example: 2020-03-21

end_datestring · dateOptional

Last day for which refunds were finalised (inclusive). Defaults to tomorrow

Example: 2020-03-25

Header parameters

AuthorizationstringRequired

Token <Your_API_Key>.

Default: Token <Partner_API_key>.

Responses

200

Successful operation.

application/json

successbooleanOptional

400

Bad Request -- Check your request parameters (typo in parameter or invalid value).

application/json

401

Unauthorized -- Your API key is incorrect.

application/json

403

Forbidden -- The endpoint or parameters are not allowed for the matching API key.

application/json

404

Not Found -- Requested resource/endpoint could not be found.

application/json

405

Method Not Allowed -- Check your request method.

application/json

429

Too Many Requests -- We currently apply a fair-use policy, but we might enforce limits in the future.

application/json

500

Internal Server Error -- We had a problem with our server. Try again later.

application/json

503

Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

application/json

get

/reports/refunds

HTTPcURLJavaScriptPython

GET /v2/reports/refunds HTTP/1.1
Host: api.tiqets.com
Authorization: Token <Partner_API_key>.
Accept: */*

{
  "success": true,
  "refunds": {
    "order_reference_id": "123123",
    "basket_reference_id": "123123",
    "device": "desktop",
    "refunded_at": "2025-11-04T13:46:03.361715+01:00",
    "currency": "EUR",
    "sale_order_value_incl_vat": -51.58,
    "commission_excl_vat": -10.39,
    "sitebrand_name": "My sitebrand Tickets",
    "sitebrand_shortname": "mys"
  },
  "pagination": {
    "total": 5,
    "page": 1,
    "page_size": 100
  }
}