Metorik Docs

Reports

Orders by date

Returns order metrics over time for orders placed in the selected period.
Net values deduct refunds tied to those orders even if the refund happened later,
giving you order-focused performance rather than refund timing by period.
Responses are capped at 1500 time periods.

GET /api/v1/store/reports/orders-by-date

Orders by date

curl --request GET \
  --url 'https://{baseUrl}/api/v1/store/reports/orders-by-date' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "meta": {
    "report_link": "https://app.metorik.com/reports/orders#orders-over-time"
  },
  "totals": {
    "gross": 124550.42,
    "net": 118420.13,
    "orders": 712,
    "customers": 508,
    "items": 1196,
    "aov": 174.93,
    "aoi": 1.68,
    "discounts": 2140.55,
    "refunds": 1986.23,
    "taxes": 10334.89,
    "shipping": 5421.1,
    "fees": 882.41
  },
  "data": [
    {
      "date": "2026-03-01",
      "orders": 26,
      "customers": 22,
      "gross": 4420.55,
      "net": 4201.44,
      "items": 39,
      "aov": 170.02,
      "aoi": 1.5,
      "discounts": 88,
      "refunds": 41,
      "taxes": 366.71,
      "shipping": 192.5,
      "fees": 31.84
    }
  ]
}

No response description.

Authorizations

  • Authorization string required header

    Generate a store API key from the store's Metorik API settings in Metorik, and choose the scopes needed for the endpoints you want to call.

Query Parameters

  • end_date string required

    End date in the store timezone using YYYY-MM-DD format. Example: 2026-02-28

  • group_by string enum

    Time interval for grouping the results. Example: day

  • order_filters string

    Optional JSON-encoded array of order-level filters applied before calculating the report. See Order Filters Reference. Cannot be combined with segment. Example: [{"field":"billing_address_country","operator":"eq","value":"US"}]

  • segment integer

    Optional saved store-wide order segment ID. You can find the ID on the order segments page. Example: 123

  • start_date string required

    Start date in the store timezone using YYYY-MM-DD format. Example: 2026-02-01

Headers

  • Accept string required

    Response format header. Example: application/json

Response

application/json
  • meta object
    + Show Child Attributes
    • report_link string
  • totals object
    + Show Child Attributes
    • gross number
    • net number
    • orders integer
    • customers integer
    • items integer
    • aov number
    • aoi number
    • discounts number
    • refunds number
    • taxes number
    • shipping number
    • fees number
  • data[] object array
    + Show Child Attributes
    • date string
    • orders integer
    • customers integer
    • gross number
    • net number
    • items integer
    • aov number
    • aoi number
    • discounts integer
    • refunds integer
    • taxes number
    • shipping number
    • fees number