> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/de/integration/retrieve-a-list-of-orders.md).

# Eine Liste von Bestellungen abrufen

Gibt eine Liste von Bestellungen zurück. Die Bestellungen werden nach Erstellungsdatum sortiert zurückgegeben, wobei die neuesten Bestellungen zuerst erscheinen. Wenn teamId als Parameter festgelegt ist, werden Bestellungen für diese teamId zurückgegeben, andernfalls werden Bestellungen mit den angegebenen orderIds zurückgegeben. Wenn keine teamId angegeben ist, wird auf die durch die Authentifizierung bereitgestellte teamId zurückgegriffen.

## GET /orders

> Retrieve a list of orders

```json
{"openapi":"3.1.0","info":{"title":"integration","version":"1"},"servers":[{"url":"https://integration-BASE-URL.citrusad.com/v1/"}],"security":[{"sec0":[]}],"components":{"securitySchemes":{"sec0":{"in":"header","name":"Authorization","type":"apiKey"}}},"paths":{"/orders":{"get":{"deprecated":false,"description":"","operationId":"retrieve-a-list-of-orders","parameters":[{"description":"If a teamId is not provided, then the teamId will fall back onto the teamId provided by the authentication.","in":"query","name":"teamId","schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"format":"int32","type":"integer"}},{"in":"query","name":"skip","schema":{"format":"int32","type":"integer"}},{"in":"query","name":"orderIds","schema":{"items":{"type":"string"},"type":"array"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"orders":{"items":{"properties":{"id":{"description":"The order ID in the retailer's site. If not provided it is generated by CitrusAd in the response.","type":"string"},"orderDate":{"description":"This is the date or the date and time of the order. This must be in the format of ISO-8601 RFC 3339 standard and must be a precise, full timestamp, e.g. 2019-03-14T15:06:17+10:00","format":"date-time","type":"string"},"orderItems":{"items":{"properties":{"gtin":{"description":"The product code of the purchased product.","type":"string"},"quantity":{"description":"The quantity (units) of the product purchased.","format":"int32","type":"integer"},"regularUnitPrice":{"description":"This is regular unit price of the product in the order.  If provided, it MUST be a number.","type":"string"},"sellerId":{"description":"The unique Id of the seller. Only required if onboarding marketplace sellers. Can be left blank for non marketplace products.   There are additional requirements to integrate seller_ids, please refer to [Marketplace sellerId](https://developers.citrusad.com/integration/reference/marketplace-sellerid) for more information.","type":"string"},"totalOrderItemPriceAfterDiscounts":{"description":"This is the total price of the products with discounts. It MUST be a number, e.g. if an order item contains 3 items with a price of 2.00, the value will be 6.","type":"string"}},"required":["gtin","quantity","totalOrderItemPriceAfterDiscounts"],"type":"object"},"type":"array"},"sessionId":{"description":"Unique sessionId used for attribution. Required to be consistent between a user's session and order reporting.","type":"string"}},"type":"object"},"type":"array"}},"type":"object"}}}},"responses":{"200":{"content":{"application/json":{}},"description":"200"},"400":{"content":{"application/json":{"schema":{"properties":{"additionalInfo":{"items":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object"},"type":"array"},"message":{"type":"string"}},"type":"object"}}},"description":"400"},"401":{"content":{"text/plain":{}},"description":"401"},"403":{"content":{"text/plain":{}},"description":"403"},"404":{"content":{"text/plain":{}},"description":"404"},"429":{"content":{"text/plain":{}},"description":"429"},"500":{"content":{"text/plain":{}},"description":"500"},"502":{"content":{"text/plain":{}},"description":"502"},"503":{"content":{"text/plain":{}},"description":"503"},"504":{"content":{"text/plain":{}},"description":"504"}},"summary":"Retrieve a list of orders"}}}}
```


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.citrusad.com/retail-media-interface/integration/de/integration/retrieve-a-list-of-orders.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.