> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prophecy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List releases

> List a project's versions with the `Versions` GraphQL query.

Use the `Versions` query to list a project's versions. Copy a release's exact version name from the response when you [trigger a pipeline run](https://docs.prophecy.ai/api-reference/pipelines/trigger-pipeline-run.md) for a published release.

```
POST /api/md/graphql
```

## Arguments

**projectUID** `string` *required*

ID of the project whose releases to list, as returned in `data.addProject._id` when you [create
the project](https://docs.prophecy.ai/api-reference/projects/create-project.md).

## Response

**data.Versions** `object[]`

Versions of the project.

**Version properties**

**version** `string`

Version name. Use this value exactly as listed.

**versionType** `string`

Type of version. Entries with `Published` are releases.

**commitHash** `string`

Hash of the commit the version points to.

**created** `integer`

Time the version was created, in milliseconds since the Unix epoch.

```bash cURL theme={null}
QUERY=$(tr '\n' ' ' <<'EOF'
query($p: String!) {
  Versions(projectUID: $p) { version versionType commitHash created }
}
EOF
)
VARS='{"p": "<PROJECT_ID>"}'
curl -sS "$PROPHECY_URL/api/md/graphql" \
  -H "X-Auth-Token: $PROPHECY_TOKEN" -H "Content-Type: application/json" \
  -d "$(printf '{"query": "%s", "variables": %s}' "$QUERY" "$VARS")"
```

```json Response theme={null}
{
  "data": {
    "Versions": [
      {
        "version": "0.1.0",
        "versionType": "Published",
        "commitHash": "<COMMIT_HASH>",
        "created": 1792561681606
      }
    ]
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.