# Bestellliste für angegebenen Zeitraum abrufen

Ruft eine Liste der Bestellungen ab, geordnet vom ältesten bis zum jüngsten Erstellungsdatum.

Endpoint: POST /v3/project/{project_id}/admin/order/search
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.
    Example: 44056

## Request fields (application/json):

  - `created_date_from` (string)
    Startdatum (mit oder ohne Uhrzeit) des Bestellzeitraums gemäß [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).
    Example: "2020-04-15T18:16:00+05:00"

  - `created_date_until` (string)
    Enddatum (mit oder ohne Uhrzeit) des Bestellzeitraums gemäß [ ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).
    Example: "2020-04-16T18:16:00+05:00"

  - `limit` (integer)
    Wie viele Bestellungen in der Antwort maximal enthalten sein dürfen.

  - `offset` (integer)
    Die Nummer der Bestellung aus der generierten Liste (die Zählung beginnt bei 0).

## Response 200 fields (application/json):

  - `has_more` (boolean)
    Ob weitere Seiten vorhanden sind.
    Example: true

  - `orders` (array)
    Bestellliste.

  - `orders.coupons` (array,null)
    Liste der bei der Bestellung eingelösten Gutscheine.

  - `orders.coupons.code` (string)
    Verwendeter Gutscheincode. Einzigartiger Code, bei dem zwischen Groß- und Kleinschreibung unterschieden wird. Enthält Buchstaben und Ziffern.

  - `orders.coupons.coupon_id` (integer)
    Die von Xsolla beim Erstellen einer Gutscheinaktion generierte Gutschein-ID.

  - `orders.coupons.sku` (string)
    Die von Xsolla beim Erstellen einer Gutscheinaktion generierte Gutschein-SKU.

  - `orders.coupons.type` (string)
    Gutscheintyp.
    Enum: "unique_catalog_offer", "coupon", "promocode"

  - `orders.date_created` (string)
    Datum (mit oder ohne Uhrzeit), an dem die Bestellung angelegt wurde, gemäß [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).
    Example: "2020-08-11T10:00:00+03:00"

  - `orders.invoice_id` (string)
    Rechnungs-ID.

  - `orders.is_free` (boolean)
    Ob die Bestellung kostenlos ist.

  - `orders.items` (array)
    Artikelliste.

  - `orders.items.description` (object,null)
    Objekt mit lnformationen über den Artikel.

  - `orders.items.description.description` (string)
    Artikelbeschreibung.

  - `orders.items.description.image_url` (string)
    URL des Artikelbildes.

  - `orders.items.description.name` (string)
    Artikelname.

  - `orders.items.is_bonus` (boolean)
    Ob es sich bei dem Artikel um einen Bonus handelt.

  - `orders.items.is_free` (boolean)
    Ob der Artikel kostenlos ist.

  - `orders.items.item_id` (integer)
    Artikel-ID. Wird von Xsolla beim Erstellen eines Artikels generiert.
    Example: 1

  - `orders.items.order_item_id` (integer)
    Artikel-ID in der Bestellung. Die ID wird von Xsolla beim Anlegen der Bestellung generiert.

  - `orders.items.price` (object,null)
    Artikelpreis.

  - `orders.items.price.amount` (string)
    Reduzierter Artikelpreis.
    Example: "30"

  - `orders.items.price.amount_without_discount` (string)
    Artikelpreis ohne Rabatte.
    Example: "30"

  - `orders.items.price.currency` (string)
    SKU der virtuellen Währung oder dreistelliger Code gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Detaillierte Informationen zu den [von Xsolla unterstützten Währungen](https://developers.xsolla.com/de/doc/pay-station/references/supported-currencies/) finden Sie in der Dokumentation.
    Example: "USD"

  - `orders.items.price.is_virtual_currency` (boolean)
    Ob die Währung virtuell ist.

  - `orders.items.quantity` (integer)
    Artikelmenge.
    Example: 1

  - `orders.items.region_id` (integer,null)
    ID der Region, in der der Artikel verfügbar ist. Weitere Informationen zu regionalen Verkaufsbeschränkungen finden Sie in der [Dokumentation](https://developers.xsolla.com/de/doc/shop-builder/features/regional-restrictions/).

  - `orders.items.sku` (string)
    Die bei der Erstellung angegebene Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten.
    Example: "elven_shield"

  - `orders.items.tax_category` (string)
    Steuerkategorie.
    Example: "DG00002"

  - `orders.items.type` (string)
    Artikeltyp.
    Enum: "virtual_good", "virtual_currency", "bundle", "game_key", "physical_good", "value_point"

  - `orders.mode` (string)
    Modus der Bestellanlegung.
    Enum: "default", "sandbox"

  - `orders.order_id` (integer)
    Bestell-ID.
    Example: 1

  - `orders.price` (object,null)
    Bestellpreis.

  - `orders.price.amount` (string)
    Endgültiger Bestellpreis.
    Example: "30"

  - `orders.price.amount_without_discount` (string)
    Bestellpreis ohne Rabatte.
    Example: "30"

  - `orders.price.currency` (string)
    SKU der virtuellen Währung oder dreistelliger Code der echten Währung gemäß [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Detaillierte Informationen zu den [von Xsolla unterstützten Währungen](https://developers.xsolla.com/de/doc/pay-station/references/supported-currencies/) finden Sie in der Dokumentation.
    Example: "USD"

  - `orders.project_id` (integer)
    Projekt-ID. Dieser Parameter wird im [Kundenportal](https://publisher.xsolla.com/) neben dem Projektnamen angezeigt.
    Example: 44056

  - `orders.promotions` (array,null)
    Liste der bei der Bestellung angewendeten Werbeaktionen.

  - `orders.promotions.promotion_id` (integer)
    Werbeaktions-ID innerhalb des Projekts.
    Example: 111425

  - `orders.status` (string)
    Bestellstatus.
    Enum: "new", "paid", "done", "canceled", "expired"

  - `orders.user` (object)

  - `orders.user.country` (string)
    Zweistelliger Ländercode in Großbuchstaben gemäß [ISO 3166-1 Alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Detaillierte Informationen zu den [von Xsolla unterstützten Ländern](https://developers.xsolla.com/de/doc/shop-builder/references/supported-countries/) finden Sie in der Dokumentation.
    Example: "US"

  - `orders.user.email` (string)
    E-Mail-Adresse des Nutzers gemäß dem [RFC 822](https://www.w3.org/Protocols/rfc822/#z8)-Protokoll.
    Example: "user@xsolla.com"

  - `orders.user.id` (string)
    Benutzer-ID, die beim Anlegen der Bestellung übermittelt wird.
    Example: "07e653a2b15011e6818f005056a54369"

  - `orders.user.region_id` (integer,null)
    Region-ID des Nutzers. Wird zurückgegeben, wenn regionale Verkaufsbeschränkungen festgelegt sind. Das Land des Nutzers, das beim Anlegen der Bestellung übermittelt wurde, wird mit der Liste der Länder abgeglichen, die beim [Erstellen der Region](https://developers.xsolla.com/de/api/shop-builder/operation/admin-create-region/) angegeben wurden. Weitere Informationen zu regionalen Verkaufsbeschränkungen finden Sie in der [Dokumentation](https://developers.xsolla.com/de/doc/shop-builder/features/regional-restrictions/).
    Example: 12

  - `total_items_count` (integer)
    Die Gesamtzahl der Bestellungen im angegebenen Zeitraum.
    Example: 1

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

  - `statusCode` (integer)
    Example: 401