---
title: "Get a list of versions"
method: GET
path: "/projects/{projectId}/versions"
tags: ["Versions"]
---

# Get a list of versions

`GET /projects/{projectId}/versions`

## Request

- Base URL: `https://app.ketryx.com/api/v1`
- URL: `https://app.ketryx.com/api/v1/projects/{projectId}/versions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ketryx/apis/ketryx-api/docs/projects/:projectId/versions/get.ts> (a function with typed inputs; its response is checked against the schema)

Gets a list of versions in the given project.

## Response `200`

OK

- object
  - `versions` object[]
    - `id` string
    - `name` string
    - `versionNumber` string, nullable: The computed version number based on the project's version number pattern. May be null for scoped versions without an explicit number.
    - `scopeDescription` object, nullable: The scope description in JDF (JSON Document Format) rich text format.
      - `type` 'jdf'
      - `value` object: The JDF document content.

## Other responses

- `400`: The request is not valid.
- `401`: The requester is not authenticated.
- `403`: The requester is unauthorized.
- `404`: The resource was not found.

---

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