Skip to content

Analytics summary

Read time: 3 minutes. Who it's for: Developers feeding QuotWay metrics into a BI tool, spreadsheet or dashboard.

⚠️ Requires the Enterprise plan and the read_analytics scope.

Get the summary - GET /v1/analytics/summary

curl -G https://api.quotway.com/v1/analytics/summary \
  -H "Authorization: Bearer $QUOTWAY_API_KEY" \
  --data-urlencode "period=week" \
  --data-urlencode "limit=4"
Parameter Description
period day, week or month. Default month. Weeks start on Monday (ISO weeks); all periods are in UTC.
limit How many periods to return, 1–36. Default 12.
{
  "object": "analytics_summary",
  "period": "week",
  "currency": "USD",
  "data": [
    {
      "period_start": "2026-09-28T00:00:00.000Z",
      "period_end": "2026-10-05T00:00:00.000Z",
      "quotes": {
        "total": 31,
        "new": 12,
        "accepted": 5,
        "partially_accepted": 2,
        "declined": 3,
        "expired": 1,
        "converted": 4
      },
      "value": {
        "accepted": "18450.00",
        "pipeline": "62310.50",
        "converted": "14200.00"
      },
      "avg_discount_pct": 7.4,
      "avg_first_response_minutes": 96.5,
      "avg_negotiation_days": 3.2,
      "avg_conversion_days": 1.8,
      "computed_at": "2026-09-30T02:30:14.221Z"
    }
  ]
}

Periods are returned newest first.

Field Description
currency The store's base currency. Every money value is converted into it.
quotes.* Counts of quotes in the period - total, new, accepted in full, partially accepted, declined, expired and converted.
value.accepted Value of quotes accepted in the period.
value.pipeline Value of open quotes, observed when the period was last computed (a point-in-time figure).
value.converted Value converted to Shopify draft orders in the period.
avg_discount_pct Average discount, in percent. null when there's nothing to average.
avg_first_response_minutes Average time to the store's first response.
avg_negotiation_days, avg_conversion_days Average negotiation and conversion times.
computed_at When the row was last computed.

How fresh is it?

The summary reads pre-computed snapshots, never live data, so it's fast and cheap to call.

  • Days are computed once they're complete, in a nightly run at about 02:30 UTC. Today isn't included.
  • The current week and month are recomputed each night from the days so far, so they grow until the period ends.
  • Periods with no snapshot are simply absent. Snapshots that were back-filled for older dates carry a pipeline value of 0.00, because the pipeline can only be observed on the night.

For live, per-quote figures, sync quotes instead (see Pagination).

Still need a hand? The team is happy to help.

We’d like to set analytics cookies to understand how the site is used. They’re not required — declining changes nothing about how the site works, and you can change your mind any time on our privacy page.