Metorik Docs

Reports

Carts started by date

Returns cart started, abandoned, placed, and recovered counts and amounts
over time for the selected period. Responses are capped at 1500 time periods.
Your store must already have cart tracking/data set up in Metorik for this
report to return meaningful cart activity.

GET /api/v1/store/reports/carts-started-by-date

Carts started by date

curl --request GET \
  --url 'https://{baseUrl}/api/v1/store/reports/carts-started-by-date' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "meta": {
    "report_link": "https://app.metorik.com/reports/carts",
    "results_limited": false,
    "has_active_recovery_emails": true
  },
  "totals": {
    "started": 6,
    "started_amount": 412.5,
    "started_items": 9,
    "abandoned": 2,
    "abandoned_amount": 145,
    "placed": 3,
    "placed_amount": 201,
    "recovered": 1,
    "recovered_amount": 66.5
  },
  "data": [
    {
      "date": "2026-03-01",
      "label": "Mar 1, 2026",
      "started": 2,
      "started_amount": 120,
      "started_items": 3,
      "abandoned": 1,
      "abandoned_amount": 45,
      "placed": 1,
      "placed_amount": 75,
      "recovered": 0,
      "recovered_amount": 0
    }
  ]
}

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

  • 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
    • results_limited boolean
    • has_active_recovery_emails boolean
  • totals object
    + Show Child Attributes
    • started integer
    • started_amount number
    • started_items integer
    • abandoned integer
    • abandoned_amount integer
    • placed integer
    • placed_amount integer
    • recovered integer
    • recovered_amount number
  • data[] object array
    + Show Child Attributes
    • date string
    • label string
    • started integer
    • started_amount integer
    • started_items integer
    • abandoned integer
    • abandoned_amount integer
    • placed integer
    • placed_amount integer
    • recovered integer
    • recovered_amount integer