Metorik Docs

Reports

Customers by date

Returns new customers over time together with their related lifetime order
count, spend, and item totals for each period. Responses are capped at
1500 time periods.

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

Customers by date

curl --request GET \
  --url 'https://{baseUrl}/api/v1/store/reports/customers-by-date' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "meta": {
    "report_link": "https://app.metorik.com/reports/customers#customers-over-time"
  },
  "totals": {
    "gross": 124550.42,
    "orders": 712,
    "customers": 508,
    "items": 1196
  },
  "data": [
    {
      "date": "2026-03-01",
      "customers": 18,
      "orders": 26,
      "gross": 4420.55,
      "items": 39
    },
    {
      "date": "2026-03-02",
      "customers": 21,
      "orders": 30,
      "gross": 4988.1,
      "items": 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

  • customer_filters string

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

  • 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

  • segment integer

    Optional saved store-wide customer segment ID. You can find the ID on the customer 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
    • customers integer
    • items integer
  • data[] object array
    + Show Child Attributes
    • date string
    • customers integer
    • orders integer
    • gross number
    • items integer