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

# List Environments

> Returns all environments configured for your tenant

## List Environments

```text theme={"dark"}
GET /v1/environments
```

Returns all environments for your tenant (not paginated — returns the full list).

### Response

```json theme={"dark"}
{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "production",
      "display_name": "Production",
      "description": "Live production environment",
      "color": "#22c55e",
      "is_default": true,
      "created_at": "2026-01-01T00:00:00.000Z"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "staging",
      "display_name": "Staging",
      "description": "Pre-production testing",
      "color": "#f59e0b",
      "is_default": false,
      "created_at": "2026-01-15T10:00:00.000Z"
    }
  ],
  "meta": { "request_id": "550e8400-e29b-41d4-a716-446655440000" }
}
```

<CodeGroup>
  ```bash cURL theme={"dark"}
  curl https://api.knoxcall.com/v1/environments \
    -H "Authorization: Bearer tk_a1b2c3d4_xxxxxxxx..."
  ```

  ```python Python theme={"dark"}
  import requests

  resp = requests.get(
      "https://api.knoxcall.com/v1/environments",
      headers={"Authorization": "Bearer tk_a1b2c3d4_xxxxxxxx..."}
  )
  environments = resp.json()["data"]
  ```

  ```javascript Node.js theme={"dark"}
  const resp = await fetch("https://api.knoxcall.com/v1/environments", {
    headers: { Authorization: "Bearer tk_a1b2c3d4_xxxxxxxx..." }
  });
  const { data: environments } = await resp.json();
  ```
</CodeGroup>