---
title: "Get the names and statuses of files that changed since a commit"
method: GET
path: "/version/files"
tags: ["versioning"]
---

# Get the names and statuses of files that changed since a commit

`GET /version/files`

Get the names and statuses of files that changed since a commit. Default is the latest commit (HEAD).

## Query parameters

- `commit` string

## Response `200`

The requested GitFilesResponse object in a single-item list.

- CountedGitFilesResponse
  - `count` integer, required — number of items present in the items array
  - `items` GitFilesResponse[], required — List of items in this response.
    - `commitMessage` string — Commit message of the specified commit.
    - `count` integer, required — Number of files returned.
    - `items` GitFile[], required — Array of files that changed since the specified commit.
      - `autoIncludedInCommit` boolean — If <code>true</code>, this file is automatically included in commits without being explicitly listed. Otherwise, <code>false</code>.
      - `children` GitFile[] — When this entry is a directory, nested files and subdirectories. Each array element matches this same object shape (recursive file tree).
      - `name` string, required — Path of the file relative to the configuration root.
      - `state` string — Git status code for the file: <code>M</code> for modified, <code>A</code> for added, or <code>D</code> for deleted.

## Other responses

- `401` — Authentication failed (missing or invalid credentials or Bearer token).
- `500` — Unexpected server error.

---

[API](https://skmtc.dev/criblio/apis/cribl-api-reference.md) · [All operations](https://skmtc.dev/criblio/apis/cribl-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/criblio/cribl-api-reference/revisions/56cb25079271/schema)