> For the complete documentation index, see [llms.txt](https://developers.tiqets.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.tiqets.dev/basics/openapi/booking-api/list-orders.md). # List orders Lists all orders that the distributor has generated, sorted descending by the order creation date. ## GET /orders > List orders ```json {"openapi":"3.1.0","info":{"title":"Tiqets Distributor API","version":"2.7.0"},"tags":[{"name":"Booking API"}],"servers":[{"url":"https://api.tiqets.com/v2","description":"Production Environment"},{"url":"https://api-tiqt-test.steq.it/v2","description":"Test Environment (until February 4th, 2026)"},{"url":"https://api.api-tiqt-test.steq.it/v2","description":"Test Environment (from February 4th, 2026)"}],"paths":{"/orders":{"get":{"tags":["Booking API"],"summary":"List orders","parameters":[{"$ref":"#/components/parameters/Authorization"},{"$ref":"#/components/parameters/PageSize"},{"$ref":"#/components/parameters/Page"},{"name":"start_date","in":"query","description":"First day for which to return list of orders (default: 30 days before the current date).","required":false,"schema":{"type":"string","format":"date","pattern":"YYYY-MM-DD"}},{"name":"end_date","in":"query","description":"Last day for which to return list of orders. (default: the current date).","schema":{"type":"string","format":"date","pattern":"YYYY-MM-DD"}}],"responses":{"200":{"description":"Successful operation.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"pagination":{"$ref":"#/components/schemas/Pagination"},"order":{"type":["array","null"],"items":{"$ref":"#/components/schemas/Order"}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}}},"components":{"parameters":{"Authorization":{"name":"Authorization","in":"header","required":true,"description":"Token .","schema":{"type":"string","default":"Token ."}},"PageSize":{"name":"page_size","in":"query","description":"Number of items per page. Default value is 10, maximum value is 100.","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":10}},"Page":{"name":"page","in":"query","description":"Number of the page to retrieve. Used in combination with the `page_size` parameter to define the page size.","required":false,"schema":{"type":"integer","minimum":1,"default":1}}},"schemas":{"Pagination":{"type":"object","properties":{"total":{"type":"integer","description":"Total number of items."},"page":{"type":"integer","description":"Number of the current page."},"page_size":{"type":"integer","description":"Size of the current page."}}},"Order":{"type":"object","properties":{"external_reference":{"type":["string","null"],"description":"Partner's order reference ID as provided upon order creation through Booking API. Unique, maximum 255 characters. Not applicable for non-Booking API orders."},"order_reference_id":{"type":"string","description":"Order reference ID of the order."},"basket_reference_id":{"type":"string","description":"Basket reference ID of the order."},"product_id":{"type":"integer","description":"ID of the product."},"order_date":{"type":"string","format":"date","description":"Date when the order was created. Always follows 'Europe/Amsterdam' timezone. It is recommended to prefer `order_created_timestamp` for the exact timestamp of the order creation."},"order_created_timestamp":{"type":"string","format":"date-time","description":"Date and time when the order was created formatted according to ISO-8601 standard. Always follows UTC timezone."},"visit_date":{"type":["string","null"],"format":"date","description":"Visit date selected by the guest during or after the order process. Can be null if the visit date has not been selected yet."},"number_of_tickets":{"type":"integer","description":"Total number of tickets in the order."},"sale_order_value":{"type":"number","description":"Sale order value (excluding VAT) which is the sum of all the tickets value in the order."},"estimated_commission":{"type":["number","null"],"description":"Estimated total distributor commission of the order (excluding VAT)."},"estimated_partner_rate":{"type":["number","null"],"description":"As an intermediary of Tiqets, you receive a partner commission for your services in accordance with your partner contract. The Estimated Partner Rate is merely displayed to indicate the estimated difference between the ticket retail price (including VAT) and your estimated partner commission (excluding VAT). No rights can be derived from this estimation. The terms of your partner contract shall prevail and take precedence in all cases."},"currency":{"type":"string","description":"Currency code (ISO 4217) for the existing amounts. The returned currency follows the invoice currency."},"sitebrand":{"type":["string","null"],"description":"Name of partner's co-branded version of Tiqets.com."},"source_tool":{"type":["string","null"],"description":"Affiliate tool used by user to create the order. This entire field and value will be omitted if the order was created through the Booking API.","enum":["affiliate_link","discovery_widget","availability_widget","booking_widget"]},"campaign_name":{"type":["string","null"],"description":"Partner's campaign name. Only applicable for non-Booking API orders."},"click_id":{"type":["string","null"],"description":"Partner's click ID. Only applicable for non-Booking API orders."},"order_type":{"type":"string","description":"The order type:\n* Regular: Order consisting of a single product.\n* Bundle: Order consisting of different products combined together with a discount.\n* Combi deal: Order of a product with additional products selected to be bought together with a discount during the order proces.\n* Package: Order of a predefined package which consists of different products with a discount on the total price.","enum":["REGULAR","BUNDLE","COMBI_DEAL","PACKAGE"]},"order_status":{"type":"string","enum":["new","pending","failed","done","cancelled"],"description":"The order status, as one of the following values:\n\n\n* new: Order was created, but not yet confirmed or paid.\n* pending: Order was confirmed or paid, and the tickets are still being processed.\n* failed: Order was not paid or the ticket processing failed.\n* done: Order was completed and PDF tickets have been generated.\n* cancelled: Order was cancelled after it had been completed."}}}},"responses":{"BadRequest":{"description":"Bad Request -- Check your request parameters (typo in parameter or invalid value).","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"string"},"field_errors":{"type":"object"}}}}}},"Unauthorized":{"description":"Unauthorized -- Your API key is incorrect.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"string"}}}}}},"Forbidden":{"description":"Forbidden -- The endpoint or parameters are not allowed for the matching API key.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"string"}}}}}},"NotFound":{"description":"Not Found -- Requested resource/endpoint could not be found.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"string"}}}}}},"MethodNotAllowed":{"description":"Method Not Allowed -- Check your request method.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"string"}}}}}},"TooManyRequests":{"description":"Too Many Requests -- We currently apply a fair-use policy, but we might enforce limits in the future.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"string"}}}}}},"InternalServerError":{"description":"Internal Server Error -- We had a problem with our server. Try again later.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"string"}}}}}},"ServiceUnavailable":{"description":"Service Unavailable -- We're temporarily offline for maintenance. Please try again later.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"},"error":{"type":"string"}}}}}}}}} ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://developers.tiqets.dev/basics/openapi/booking-api/list-orders.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.