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

# List Releases

> Retrieve all tracked releases for error correlation

## Query Parameters

<ParamField query="service_id" type="string">
  Filter by service ID
</ParamField>

<ParamField query="limit" type="number" default="20">
  Maximum releases to return
</ParamField>

## Response

<ResponseField name="releases" type="array">
  Array of release objects

  <Expandable title="Release Object">
    <ResponseField name="id" type="string">Release ID</ResponseField>
    <ResponseField name="version" type="string">Version string (e.g., "1.2.3")</ResponseField>
    <ResponseField name="service_id" type="string">Associated service</ResponseField>
    <ResponseField name="environment" type="string">Deployment environment</ResponseField>
    <ResponseField name="deployed_at" type="string">Deployment timestamp</ResponseField>
    <ResponseField name="commit_sha" type="string">Git commit SHA</ResponseField>
    <ResponseField name="error_count" type="number">Errors since release</ResponseField>
    <ResponseField name="new_errors" type="number">New error signatures in this release</ResponseField>
    <ResponseField name="regressed_errors" type="number">Previously resolved errors that regressed</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://kodostatus.com/api/v1/releases?service_id=svc_abc123" \
    -H "X-API-Key: your_api_key"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    'https://kodostatus.com/api/v1/releases?service_id=svc_abc123',
    { headers: { 'X-API-Key': 'your_api_key' } }
  );
  const { releases } = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "releases": [
      {
        "id": "rel_abc123",
        "version": "1.2.3",
        "service_id": "svc_abc123",
        "environment": "production",
        "deployed_at": "2024-01-15T10:00:00Z",
        "commit_sha": "a1b2c3d4e5f6g7h8",
        "error_count": 47,
        "new_errors": 3,
        "regressed_errors": 1
      },
      {
        "id": "rel_xyz789",
        "version": "1.2.2",
        "service_id": "svc_abc123",
        "environment": "production",
        "deployed_at": "2024-01-10T14:00:00Z",
        "commit_sha": "z9y8x7w6v5u4t3s2",
        "error_count": 156,
        "new_errors": 0,
        "regressed_errors": 0
      }
    ]
  }
  ```
</ResponseExample>