Metorik Docs

Reports

Revenue by date

Returns revenue metrics over time for the selected period. Net revenue is calculated
by deducting refunds when they happen, even if they relate to orders outside this period,
along with other deductions based on your store settings. Responses are capped at
1500 time periods.

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

Revenue by date

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

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
    • orders integer
    • items integer
    • discounts number
    • refunds number
    • refunds_count integer
    • taxes number
    • shipping number
    • fees number
    • net number
  • data[] object array
    + Show Child Attributes
    • date string
    • gross number
    • orders integer
    • items integer
    • discounts integer
    • refunds integer
    • refunds_count integer
    • taxes number
    • shipping number
    • fees number
    • net number