v1

latestOpenAPI 3.0.3MIT2026-07-1411163326.7 KB
Insights

Job timeseries data

Get timeseries data for all jobs within a workflow. Hourly granularity data is only retained for 48 hours while daily granularity data is retained for 90 days.

get/insights/time-series/{project-slug}/workflows/{workflow-name}/jobs

Path parameters

project-slugstring required

Project slug in the form vcs-slug/org-name/repo-name. The / characters may be URL-escaped. For projects that use GitLab or GitHub App, use circleci as the vcs-slug, replace org-name with the organization ID (found in Organization Settings), and replace repo-name with the project ID (found in Project Settings).

workflow-namestring required

The name of the workflow.

Query parameters

branchstring

The name of a vcs branch. If not passed we will scope the API call to the default branch.

granularity'daily' | 'hourly'

The granularity for which to query timeseries data.

start-datestring date-time

Include only executions that started at or after this date. This must be specified if an end-date is provided.

end-datestring date-time

Include only executions that started before this date. This date can be at most 90 days after the start-date.

Response

An array of timeseries data, one entry per job.

next_page_tokenstring required

A token to pass as a page-token query parameter to return the next page of results.

Example response

{
  "items": [
    {
      "name": "build-and-test"
    }
  ]
}