# A21 - Get shop statistics

Call Frequency

Recommended usage: Once per day
Maximum usage: Once per day

Endpoint: GET /api/account/statistics

## Query parameters:

  - `periods` (string)
    List of periods using a comma (,) as a separator. Accepted values are ALL_SINCE_BEGINNING, LAST_MONTH, LAST_THREE_MONTHS, LAST_SIX_MONTHS, LAST_YEAR. If specified, only statistics for the given periods will be returned. If not, all statistics will be returned.

  - `channel_code` (string)
    The code of the channel to filter statistics on. If not specified, the overall statistics will be returned.

  - `shop_id` (integer)
    Use this parameter when your user has access to several shops. If not specified, the shop_id from your default shop will be used.

## Response 200 fields (application/json):

  - `approval_delay` (array)
    The average time period (in seconds) between when an order notification is sent to the shop and when the order is accepted.

  - `approval_delay.period` (string)
    The statistic period
    Enum: "ALL_SINCE_BEGINNING", "LAST_MONTH", "LAST_THREE_MONTHS", "LAST_SIX_MONTHS", "LAST_YEAR"

  - `approval_delay.value` (integer)
    The statistic value

  - `approval_rate` (array)
    The number of accepted order lines divided by the total number of accepted and rejected order lines.

  - `auto_refused_rate` (array)
    The number of automatically rejected order lines divided by the total number of order lines submitted for approval.

  - `average_cart` (array)
    Total of accepted order sales amount (tax included) divided by total accepted orders.

  - `average_cart_with_shipping` (array)
    Total of accepted order sales amount (tax included) with shipping divided by total accepted orders.

  - `cancelation_rate` (array)
    The number of accepted order lines with at least one cancelation divided by the total number of accepted order lines.

  - `channel` (string)
    Channel code. If no channel is specified in the query params, this field is null

  - `consecutive_refused_orders_count` (array)
    Number of consecutive orders refused by the shop. Only present when the channelCode filter is not present.

  - `evaluations_count` (array)
    Number of shop evaluations

  - `grade` (array)
    Global grade of the shop

  - `incident_rate` (array)
    The number of order lines with at least one incident divided by the total number of accepted order lines.

  - `last_updated_date` (string)
    Date and time when these statistics were last calculated.

  - `late_shipment_rate` (array)
    The number of orders shipped later than the shipping deadline divided by the total number of orders.

  - `offers_count` (array)
    Total count of active offers of the shop. Only present when the channelCode filter is not present.

  - `order_messages_response_delay` (array)
    The average time period (in seconds) in which the shop responds to a customer's order-related message.

  - `orders_count` (array)
    Total count of debited orders. Includes accepted orders for Pay on Delivery payment method.

  - `refund_rate` (array)
    The number of order lines with at least one refund divided by the total number of accepted order lines.

  - `return_rate` (array)
    The number of order lines with at least one return divided by the total number of returnable order lines.

  - `shipping_delay` (array)
    The average time period (in seconds) in which an order with the "Awaiting shipment" status is shipped.

  - `shop_id` (integer)
    The identifier of the shop

  - `total_revenue` (array)
    Total shop revenue

  - `valid_tracking_rate` (array)
    The number of orders with a valid tracking divided by the total number of orders minus orders having an uncovered shipment. Return null if Mirakl Delivery Manager is not activated