# OR13 - Export orders asynchronously

The API returns a tracking id to be used to query API OR14.Mirakl recommends to use API OR13 instead of API OR11 as it can handle very large volumes of data.You must give at least one date range filter: created, last updated date or refunds created date.API OR13 supports the chunk of the export file into multiple files in order to:respect a maximum megabyte weight using the megabytes_per_chunk parameter.respect a maximum amount of exported items using the items_per_chunk parameter.Only one export request can be created for all operator users, and one per partner.Call FrequencyRecommended usage: - Differential: every 15 minutesMaximum usage: - Differential: every 5 minutes - Full: every 24 hoursLocalizationThis resource supports locale parameter (see documentation)Localized output fields will be highlighted with an icon: 

Endpoint: POST /api/orders/async-export

## Request fields (application/json):

  - `channel_codes` (array)
    A list of channel codes

  - `end_date` (string)
    End order creation date for filtering. Must be used with start_date.

  - `end_refund_creation_date` (string)
    End refund creation date to filter on orders with at least one refund created before this date. Must be used with start_refund_creation_date, and cannot be later than a month after start_refund_creation_date.

  - `end_update_date` (string)
    End order update date for filtering. Must be used with start_update_date.

  - `fulfillment_center_codes` (string)
    Code of the fulfillment center

  - `items_per_chunk` (integer)
    Maximum number of items included in the generated files

  - `megabytes_per_chunk` (integer)
    Maximum mega bytes weight for generated files

  - `only_null_channel` (boolean)
    Return only orders without channel. If true, ignore the channel_codes

  - `order_state_codes` (array)
    A list of order state's codes
    Enum: "STAGING", "WAITING_ACCEPTANCE", "WAITING_DEBIT", "WAITING_DEBIT_PAYMENT", "SHIPPING", "SHIPPED", "TO_COLLECT", "RECEIVED", "CLOSED", "REFUSED", "CANCELED"

  - `order_tax_mode` (string)
    Please note: If the taxes are not specified, the prices with mode TAX_EXCLUDED and with mode TAX_INCLUDED will return the same amounts.Possible values:TAX_EXCLUDED: the price fields (price, unit price, shipping price, cancellation amount, refund amount and order total prices) do not include taxes.TAX_INCLUDED: the price fields include the tax amount. If this query parameter is not specified, the default order tax mode of the platform is used.
    Enum: "TAX_INCLUDED", "TAX_EXCLUDED"

  - `refund_state_codes` (array)
    Filter on the refund state
To be used in combination with filters start_update_date and end_update_date, with a maximum of one month period.
    Enum: "WAITING_REFUND_TAX_CONFIRMATION", "WAITING_REFUND", "WAITING_REFUND_PAYMENT", "REFUNDED"

  - `shop_ids` (array)
    A list of shop's identifiers

  - `start_date` (string)
    Start order creation date for filtering. Must be used with end_date.

  - `start_refund_creation_date` (string)
    Start refund creation date to filter on orders with at least one refund created after this date. Must be used with end_refund_creation_date.

  - `start_update_date` (string)
    Start order update date for filtering. Mirakl will subtract a time delta to ensure no orders are missed due to network and/or software latency. Must be used with end_update_date.

  - `tax_recalculation_required_only` (boolean)
    If true returns only orders for which taxes must be recalculated on at least one order line. When false it does not impact the result. Must be used with at least one date range filter: created or last updated date, of a maximum duration of one month.

  - `waiting_funding_confirmation` (boolean)
    If true returns only orders awaiting a funding update. When false it does not impact the result.

  - `waiting_tax_confirmation` (boolean)
    If true returns only orders awaiting a tax confirmation, When false it does not impact the result.

## Response 200 fields (application/json):

  - `tracking_id` (string, required)
    Id to poll in order to track the export's progress