# Lire la liste des commandes pour la période spécifiée

Récupère la liste des commandes, triées par date de création dans un ordre croissant.

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

## Path parameters:

  - `project_id` (integer, required)
    ID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.
    Example: 44056

## Request fields (application/json):

  - `created_date_from` (string)
    Date de début ou date-heure de la période de création de la commande selon la norme [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).
    Example: "2020-04-15T18:16:00+05:00"

  - `created_date_until` (string)
    Date de fin ou date-heure de la période de création de la commande selon la norme [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).
    Example: "2020-04-16T18:16:00+05:00"

  - `limit` (integer)
    Limite sur le nombre de commandes incluses dans la réponse.

  - `offset` (integer)
    Numéro de commande à partir de laquelle la liste est générée (le décompte commence à 0).

## Response 200 fields (application/json):

  - `has_more` (boolean)
    Détermine la présence de pages supplémentaires.
    Example: true

  - `orders` (array)
    Liste des commandes.

  - `orders.coupons` (array,null)
    Liste de coupons appliqués à la commande.

  - `orders.coupons.code` (string)
    Code du coupon utilisé. Code unique sensible à la casse. Contient des lettres et des chiffres.

  - `orders.coupons.coupon_id` (integer)
    ID du coupon, généré par Xsolla lors de la création d'une promotion par coupon.

  - `orders.coupons.sku` (string)
    UGS du coupon, générée par Xsolla lors de la création d'une promotion par coupon.

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

  - `orders.date_created` (string)
    Date de création de la commande ou code date-heure selon la norme [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).
    Example: "2020-08-11T10:00:00+03:00"

  - `orders.invoice_id` (string)
    ID de facture.

  - `orders.is_free` (boolean)
    Détermine la gratuité de la commande.

  - `orders.items` (array)
    Liste des objets.

  - `orders.items.description` (object,null)
    Objet contenant des informations sur le bien.

  - `orders.items.description.description` (string)
    Description de l'objet.

  - `orders.items.description.image_url` (string)
    URL de l'image de l'objet.

  - `orders.items.description.name` (string)
    Nom de l'objet.

  - `orders.items.is_bonus` (boolean)
    Détermine si l'objet est un bonus.

  - `orders.items.is_free` (boolean)
    Détermine la gratuité de l'objet.

  - `orders.items.item_id` (integer)
    ID d'objet. Il est généré par Xsolla lors de la création d'un objet.
    Example: 1

  - `orders.items.order_item_id` (integer)
    ID de l'objet dans la commande. Il est généré par Xsolla lors de la création de la commande.

  - `orders.items.price` (object,null)
    Prix de l'objet.

  - `orders.items.price.amount` (string)
    Prix de l'objet avec remise.
    Example: "30"

  - `orders.items.price.amount_without_discount` (string)
    Prix de l'objet sans remise.
    Example: "30"

  - `orders.items.price.currency` (string)
    UGS de la monnaie virtuelle ou code à trois lettres selon la norme [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Consultez la documentation pour obtenir des informations détaillées sur les [devises prises en charge par Xsolla](https://developers.xsolla.com/fr/doc/pay-station/references/supported-currencies/).
    Example: "USD"

  - `orders.items.price.is_virtual_currency` (boolean)
    Détermine si la monnaie est virtuelle.

  - `orders.items.quantity` (integer)
    Quantité de l'objet.
    Example: 1

  - `orders.items.region_id` (integer,null)
    ID de la région où l'objet est disponible. Reportez-vous à la [documentation](https://developers.xsolla.com/fr/doc/shop-builder/features/regional-restrictions/) pour plus d'informations sur les restrictions de vente régionales.

  - `orders.items.sku` (string)
    ID de l'objet spécifié lors de sa création. L'UGS ne peut contenir que des caractères alphanumériques latins minuscules et majuscules, des points, des tirets et des traits bas.
    Example: "elven_shield"

  - `orders.items.tax_category` (string)
    Catégorie fiscale.
    Example: "DG00002"

  - `orders.items.type` (string)
    Type d'objet.
    Enum: "virtual_good", "virtual_currency", "bundle", "game_key", "physical_good", "value_point"

  - `orders.mode` (string)
    Mode de création de commandes.
    Enum: "default", "sandbox"

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

  - `orders.price` (object,null)
    Prix de la commande.

  - `orders.price.amount` (string)
    Prix final de la commande.
    Example: "30"

  - `orders.price.amount_without_discount` (string)
    Prix de commande sans remise.
    Example: "30"

  - `orders.price.currency` (string)
    UGS de la monnaie virtuelle ou code à trois lettres de devise réelle selon la norme [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Consultez la documentation pour obtenir des informations détaillées sur les [devises prises en charge par Xsolla](https://developers.xsolla.com/fr/doc/pay-station/references/supported-currencies/).
    Example: "USD"

  - `orders.project_id` (integer)
    ID de projet. Ce paramètre se trouve dans le [Compte éditeur](https://publisher.xsolla.com/) à côté du nom du projet.
    Example: 44056

  - `orders.promotions` (array,null)
    Liste des promotions appliquées à la commande.

  - `orders.promotions.promotion_id` (integer)
    ID de la promotion au sein du projet.
    Example: 111425

  - `orders.status` (string)
    Statut de la commande.
    Enum: "new", "paid", "done", "canceled", "expired"

  - `orders.user` (object)

  - `orders.user.country` (string)
    Code pays à deux lettres majuscules selon la norme [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Consultez la documentation pour obtenir des informations détaillées sur les [pays pris en charge par Xsolla](https://developers.xsolla.com/fr/doc/shop-builder/references/supported-countries/).
    Example: "US"

  - `orders.user.email` (string)
    Adresse e-mail de l'utilisateur formatée selon le protocole [RFC 822](https://www.w3.org/Protocols/rfc822/#z8).
    Example: "user@xsolla.com"

  - `orders.user.id` (string)
    ID utilisateur passé lors de la création de la commande.
    Example: "07e653a2b15011e6818f005056a54369"

  - `orders.user.region_id` (integer,null)
    ID de la région de l'utilisateur. Il est renvoyé si des restrictions de vente régionales ont été configurées. Le pays de l'utilisateur, passé lors de la création de la commande, est comparé à la liste des pays spécifiés lors de la [création de la région](https://developers.xsolla.com/fr/api/shop-builder/operation/admin-create-region/). Pour plus d'informations sur les restrictions régionales de vente, consultez la [documentation](https://developers.xsolla.com/fr/doc/shop-builder/features/regional-restrictions/).
    Example: 12

  - `total_items_count` (integer)
    Nombre total de commandes pour la période spécifiée.
    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