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

# Router Health and Overview API

> Retrieve a real-time health snapshot of the Aria Compute ROUTER, including request volume, active entrypoints, uptime, and provider health status.

The Router Overview endpoint returns a concise health snapshot of the Aria Compute ROUTER. You can use it to monitor live request counts, active entrypoints, system uptime, and the aggregate health of configured providers.

This endpoint is read-only and does not require an admin role. Access it with either a valid session cookie or an `Authorization: Bearer` API key.

## Endpoint

```http theme={null}
GET /v1/router/overview
```

## Authentication

Authenticate with a session cookie or pass `Authorization: Bearer <api-key>`.

## Response

<ResponseField name="request_count" type="integer">
  Total number of requests processed by the router since startup.
</ResponseField>

<ResponseField name="active_entrypoints" type="integer">
  Number of entrypoints currently enabled and accepting traffic.
</ResponseField>

<ResponseField name="uptime_seconds" type="integer">
  Time elapsed since the router started, in seconds.
</ResponseField>

<ResponseField name="providers" type="object">
  Map of provider names to their health status.

  <Expandable title="properties">
    <ResponseField name="<provider_name>" type="string">
      Health status for the named provider. Common values: `healthy`, `degraded`, `unavailable`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "request_count": 48291,
    "active_entrypoints": 4,
    "uptime_seconds": 172800,
    "providers": {
      "openai": "healthy",
      "anthropic": "healthy",
      "ollama": "degraded"
    }
  }
  ```
</ResponseExample>

## Base URL

Use `https://router.example.com` as the host for all ROUTER API requests.


## Related topics

- [Authenticate with Aria Compute ROUTER](/api-reference/router/authentication.md)
- [aria-router runtime and FFI](/sdks/router-runtime.md)
- [AGENT API Overview: OpenAI Agents Surface](/api-reference/agent/introduction.md)
- [API keys for gateway and model access](/concepts/api-keys.md)
- [HTTP status codes and error responses](/resources/errors.md)