> ## 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 Errors

> Retrieve captured client-side errors with filtering and grouping

## Query Parameters

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

<ParamField query="status" type="string">
  Filter by error status: `new`, `resolved`, `regressed`, `ignored`
</ParamField>

<ParamField query="environment" type="string">
  Filter by environment: `production`, `staging`, `development`
</ParamField>

<ParamField query="release" type="string">
  Filter by release version
</ParamField>

<ParamField query="from" type="string">
  Start date (ISO 8601)
</ParamField>

<ParamField query="to" type="string">
  End date (ISO 8601)
</ParamField>

<ParamField query="limit" type="number" default="50">
  Maximum results (1-100)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Pagination offset
</ParamField>

## Response

<ResponseField name="errors" type="array">
  Array of error signature objects (grouped by fingerprint)

  <Expandable title="Error Object">
    <ResponseField name="id" type="string">Error signature ID</ResponseField>
    <ResponseField name="fingerprint" type="string">Unique error fingerprint</ResponseField>
    <ResponseField name="message" type="string">Error message</ResponseField>
    <ResponseField name="type" type="string">Error type (e.g., TypeError, ReferenceError)</ResponseField>
    <ResponseField name="status" type="string">new, resolved, regressed, ignored</ResponseField>
    <ResponseField name="occurrences" type="number">Total occurrence count</ResponseField>
    <ResponseField name="sessions_affected" type="number">Unique sessions affected</ResponseField>
    <ResponseField name="first_seen" type="string">First occurrence timestamp</ResponseField>
    <ResponseField name="last_seen" type="string">Most recent occurrence</ResponseField>
    <ResponseField name="release" type="string">Release version when first seen</ResponseField>
    <ResponseField name="environment" type="string">Environment</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="number">
  Total matching errors
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://kodostatus.com/api/v1/errors?status=new&environment=production&limit=20" \
    -H "X-API-Key: your_api_key"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    'https://kodostatus.com/api/v1/errors?status=new&environment=production',
    { headers: { 'X-API-Key': 'your_api_key' } }
  );
  const { errors, total } = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "errors": [
      {
        "id": "err_abc123",
        "fingerprint": "a1b2c3d4e5f6",
        "message": "Cannot read property 'map' of undefined",
        "type": "TypeError",
        "status": "new",
        "occurrences": 47,
        "sessions_affected": 23,
        "first_seen": "2024-01-15T08:30:00Z",
        "last_seen": "2024-01-15T10:45:00Z",
        "release": "1.2.3",
        "environment": "production",
        "stack_trace": "TypeError: Cannot read property 'map' of undefined\n    at Dashboard.render (dashboard.js:142:15)..."
      }
    ],
    "total": 1
  }
  ```
</ResponseExample>