---
title: "analytics.report"
method: GET
path: "/analytics.report.json"
tags: ["analytics"]
---

# analytics.report

`GET /analytics.report.json`

## Request

- Base URL: `https://api.api2cart.com/v1.1`
- URL: `https://api.api2cart.com/v1.1/analytics.report.json`
- Auth: API key in header `x-api-key` and API key in header `x-store-key`

Get analytics report with totals and optional interval breakdown for a store over a given period.

## Query parameters

- `date_from` string, required
- `date_to` string
- `interval` string
- `order_status` string
- `financial_status` string
- `currency_id` string
- `store_id` string
- `sort_by` string
- `sort_direction` string
- `response_fields` string

## Response `200`

successful operation

- ResponseAnalyticsReportResult
  - `period` AnalyticsPeriod
    - `date_from` string
    - `date_to` string
    - `additional_fields` object, nullable
    - `custom_fields` object, nullable
  - `total_metrics` AnalyticsMetric
    - `orders_count` integer, nullable
    - `items_sold` integer, nullable
    - `gross_sales` number, nullable
    - `net_sales` number, nullable
    - `total_sales` number, nullable
    - `avg_order_value` number, nullable
    - `discounts` number, nullable
    - `refunds` number, nullable
    - `tax` number, nullable
    - `shipping` number, nullable
    - `fees` number, nullable
    - `currency_id` string, nullable
    - `additional_fields` object, nullable
    - `custom_fields` object, nullable
  - `intervals` AnalyticsInterval[]
    - `date_from` string
    - `date_to` string
    - `metrics` AnalyticsMetric
      - `orders_count` integer, nullable
      - `items_sold` integer, nullable
      - `gross_sales` number, nullable
      - `net_sales` number, nullable
      - `total_sales` number, nullable
      - `avg_order_value` number, nullable
      - `discounts` number, nullable
      - `refunds` number, nullable
      - `tax` number, nullable
      - `shipping` number, nullable
      - `fees` number, nullable
      - `currency_id` string, nullable
      - `additional_fields` object, nullable
      - `custom_fields` object, nullable
    - `additional_fields` object, nullable
    - `custom_fields` object, nullable
  - `additional_fields` object, nullable
  - `custom_fields` object, nullable

---

[API](https://skmtc.dev/api2cart/apis/api2cart-openapi.md) · [All operations](https://skmtc.dev/api2cart/apis/api2cart-openapi/llms.txt) · [OpenAPI document](https://skmtc.dev/api2cart/apis/api2cart-openapi/revisions/c34440741693?raw)
