---
title: "Returns commit activity and lines-affected time series, with metric interpretations broken down by team and component."
method: GET
path: "/api/projects/{project-id}/quality/commit-activity"
tags: ["quality"]
---

# Returns commit activity and lines-affected time series, with metric interpretations broken down by team and component.

`GET /api/projects/{project-id}/quality/commit-activity`

## Request

- Base URL: `https://codescene.io` (the document declares no server; this is the origin it was published from)
- URL: `https://codescene.io/api/projects/{project-id}/quality/commit-activity`
- Auth: none declared

## Path parameters

- `project-id` integer, required

## Query parameters

- `pageSize` integer
- `pageToken` string
- `sort` string
- `from` string, date
- `to` string, date

## Response `200`

- CommitActivityStatistics
  - `projectId` integer, required: The numeric ID of the project.
  - `period` object, required: Date range covered by the commit activity series.
    - `from` string, date, required: Start date of the period (inclusive).
    - `to` string, date, required: End date of the period (inclusive).
  - `metrics` string[], required: List of metric names included in the series.
  - `series` object[], required: Ordered list of data points forming the commit activity trend.
    - `date` string, date, required: Date of this data point.
    - `commitsActivity` integer, nullable: Commit activity value for this date.
    - `linesAffected` integer, nullable: Lines affected value for this date.
  - `context` object, required: Metric interpretations for the latest values in the series.
    - `commitsActivity` object: Interpretation for the commits activity metric.
      - `interpretation` TrendInterpretation
        - `direction` 'improving' | 'declining' | 'steady', required: Normalized trend direction for reusable trend consumers.
        - `pace` 'slow' | 'fast', nullable, required: Normalized trend pace. Null when the direction is steady.
      - `status` 'stale' | 'insufficient': Reason why no trend interpretation could be produced for the current series.
      - `points` integer: Number of dated numeric samples used for interpretation.
      - `idleDays` integer: Days since the latest valid sample. Present when status is stale.
      - `minPoints` integer: Minimum number of data points required for interpretation. Present when status is insufficient.
      - `delta` number, nullable: Change in the metric over the observed series period, expressed in the metric's own unit. Null when fewer than two valid values are available.
    - `linesAffected` object: Interpretation for the lines affected metric.
      - `interpretation` TrendInterpretation
        - `direction` 'improving' | 'declining' | 'steady', required: Normalized trend direction for reusable trend consumers.
        - `pace` 'slow' | 'fast', nullable, required: Normalized trend pace. Null when the direction is steady.
      - `status` 'stale' | 'insufficient': Reason why no trend interpretation could be produced for the current series.
      - `points` integer: Number of dated numeric samples used for interpretation.
      - `idleDays` integer: Days since the latest valid sample. Present when status is stale.
      - `minPoints` integer: Minimum number of data points required for interpretation. Present when status is insufficient.
      - `delta` number, nullable: Change in the metric over the observed series period, expressed in the metric's own unit. Null when fewer than two valid values are available.
  - `teams` object[]: Per-team commit activity breakdown. Absent when no team filter is applied.
    - `teamName` string, required: Name of the team.
    - `series` object[], required: Ordered list of data points for this team.
      - `date` string, date, required: Date of this data point.
      - `commitsActivity` integer, nullable: Commit activity value for this date.
      - `linesAffected` integer, nullable: Lines affected value for this date.
    - `context` object, required: Metric interpretations for the latest values for this team.
      - `commitsActivity` object: Interpretation for the commits activity metric.
        - `interpretation` TrendInterpretation
          - `direction` 'improving' | 'declining' | 'steady', required: Normalized trend direction for reusable trend consumers.
          - `pace` 'slow' | 'fast', nullable, required: Normalized trend pace. Null when the direction is steady.
        - `status` 'stale' | 'insufficient': Reason why no trend interpretation could be produced for the current series.
        - `points` integer: Number of dated numeric samples used for interpretation.
        - `idleDays` integer: Days since the latest valid sample. Present when status is stale.
        - `minPoints` integer: Minimum number of data points required for interpretation. Present when status is insufficient.
        - `delta` number, nullable: Change in the metric over the observed series period, expressed in the metric's own unit. Null when fewer than two valid values are available.
      - `linesAffected` object: Interpretation for the lines affected metric.
        - `interpretation` TrendInterpretation
          - `direction` 'improving' | 'declining' | 'steady', required: Normalized trend direction for reusable trend consumers.
          - `pace` 'slow' | 'fast', nullable, required: Normalized trend pace. Null when the direction is steady.
        - `status` 'stale' | 'insufficient': Reason why no trend interpretation could be produced for the current series.
        - `points` integer: Number of dated numeric samples used for interpretation.
        - `idleDays` integer: Days since the latest valid sample. Present when status is stale.
        - `minPoints` integer: Minimum number of data points required for interpretation. Present when status is insufficient.
        - `delta` number, nullable: Change in the metric over the observed series period, expressed in the metric's own unit. Null when fewer than two valid values are available.
  - `components` object[]: Per-component commit activity breakdown. Absent when no component filter is applied.
    - `componentName` string, required: Name of the component.
    - `series` object[], required: Ordered list of data points for this component.
      - `date` string, date, required: Date of this data point.
      - `commitsActivity` integer, nullable: Commit activity value for this date.
      - `linesAffected` integer, nullable: Lines affected value for this date.
    - `context` object, required: Metric interpretations for the latest values for this component.
      - `commitsActivity` object: Interpretation for the commits activity metric.
        - `interpretation` TrendInterpretation
          - `direction` 'improving' | 'declining' | 'steady', required: Normalized trend direction for reusable trend consumers.
          - `pace` 'slow' | 'fast', nullable, required: Normalized trend pace. Null when the direction is steady.
        - `status` 'stale' | 'insufficient': Reason why no trend interpretation could be produced for the current series.
        - `points` integer: Number of dated numeric samples used for interpretation.
        - `idleDays` integer: Days since the latest valid sample. Present when status is stale.
        - `minPoints` integer: Minimum number of data points required for interpretation. Present when status is insufficient.
        - `delta` number, nullable: Change in the metric over the observed series period, expressed in the metric's own unit. Null when fewer than two valid values are available.
      - `linesAffected` object: Interpretation for the lines affected metric.
        - `interpretation` TrendInterpretation
          - `direction` 'improving' | 'declining' | 'steady', required: Normalized trend direction for reusable trend consumers.
          - `pace` 'slow' | 'fast', nullable, required: Normalized trend pace. Null when the direction is steady.
        - `status` 'stale' | 'insufficient': Reason why no trend interpretation could be produced for the current series.
        - `points` integer: Number of dated numeric samples used for interpretation.
        - `idleDays` integer: Days since the latest valid sample. Present when status is stale.
        - `minPoints` integer: Minimum number of data points required for interpretation. Present when status is insufficient.
        - `delta` number, nullable: Change in the metric over the observed series period, expressed in the metric's own unit. Null when fewer than two valid values are available.
  - `nextPageToken` string: Opaque cursor for the next page. Absent on the last page or when all results fit in one page.

## Other responses

- `400`
- `401`
- `403`
- `404`

---

[API](https://skmtc.dev/codescene/apis/codescene-api.md) · [All operations](https://skmtc.dev/codescene/apis/codescene-api/llms.txt) · [OpenAPI document](https://skmtc.dev/codescene/apis/codescene-api/revisions/e443e0b6bc89?raw)