---
title: "Integration delivery timeline"
method: GET
path: "/v1/sites/{site_id}/integrations/{integration_id}/stats/timeline"
tags: ["Integrations"]
---

# Integration delivery timeline

`GET /v1/sites/{site_id}/integrations/{integration_id}/stats/timeline`

## Request

- Base URL: `https://api.getsitecontrol.com`
- URL: `https://api.getsitecontrol.com/v1/sites/{site_id}/integrations/{integration_id}/stats/timeline`
- Auth: HTTP bearer

Delivery counts of one integration by current status, split into buckets by the UTC day each delivery was created. Buckets are consecutive days, calendar weeks (Monday to Sunday) or calendar months; the first and the last are cut to the period. Every bucket is present, an empty one with zeros. The period is whole UTC days, at most 31, with `from` at most 30 days before today. Statuses are the current ones, not the ones at the end of the period.

## Path parameters

- `site_id` integer, required
- `integration_id` string, required: Integration id from `list_integrations`, such as `webhook:12`

## Query parameters

- `interval` 'day' | 'week' | 'month': day, calendar week (Monday to Sunday) or calendar month.
- `from` string, date, required: First day of the period, UTC, included
- `to` string, date: Last day of the period, UTC, included; today when omitted

## Response `200`

Successful Response

- IntegrationStatsTimeline
  - `period` StatsPeriod, required
    - `date_from` string, date, required: First day, UTC, included
    - `date_to` string, date, required: Last day, UTC, included
  - `interval` 'day' | 'week' | 'month', required: day, calendar week (Monday to Sunday) or calendar month.
  - `items` IntegrationStatsBucket[], required
    - `date_from` string, date, required
    - `date_to` string, date, required
    - `total` DeliveryMetrics, required: Deliveries split by their current status, not their status back then.
      - `deliveries` integer: All of them; the sum of the statuses
      - `pending` integer
      - `succeeded` integer
      - `failed` integer
      - `cancelled` integer

## Other responses

- `400`: Unsupported GSC-Version
- `401`: Missing or invalid API key or access token
- `403`: Access denied
- `404`: `integration_not_found`: no such integration on the site, or its widget is deleted
- `422`: `stats_period_too_long`: more than 31 days. `validation_failed`: a malformed parameter, or `from` more than 30 days before today or after `to`
- `429`: Rate limited
- `503`: `temporarily_unavailable`: the delivery records could not be read in time, or limits cannot be enforced; retry later. The heavy request is spent all the same

---

[API](https://skmtc.dev/getsitecontrol/apis/getsitecontrol-public-api.md) - [All operations](https://skmtc.dev/getsitecontrol/apis/getsitecontrol-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getsitecontrol/apis/getsitecontrol-public-api/revisions/084fcad80e75?raw)