# Live quality by agent, observer and day

Source: <https://everruns.com/docs/api/operations/get_observer_summary/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Evaluation & reporting](https://everruns.com/docs/api/groups/evaluation-reporting/)/Live quality by agent, observer and day

# Live quality by agent, observer and day

Preview

Inspect agent quality, health, observers and notifications.

Public APIEverruns Cloud and self-hosted Platform

GET`/v1/observers/summary`

See [authentication](https://everruns.com/docs/sre/runbooks/authentication/) for credentials and permissions.

## Parameters

### Query Parameters

**days**

integer format: int32

Window in days (1–90). Defaults to 7.

**agent_id**

string

Only scores of this agent.

**observer_id**

string

Only scores of this observer.

## Responses

200Success

### 200

Success

Media typeapplication/json

How production traffic scored over the last `days`: in total, by agent, by observer and by day.

object

**by_agent**

required

Array\<object>

Completed scores in one group of a live-quality summary.

object

**key**

required

An agent id, an observer id or a day (`YYYY-MM-DD`), by list.

string

**pass_rate**

`passed / scored`; absent when nothing was scored.

number | null format: double

**passed**

required

integer format: int64

**scored**

required

integer format: int64

**sessions**

required

Distinct sessions the scores read.

integer format: int64

**trend**

Daily pass rates, oldest first (agent groups only).

Array\<number>

**by_day**

required

Array\<object>

Completed scores in one group of a live-quality summary.

object

**key**

required

An agent id, an observer id or a day (`YYYY-MM-DD`), by list.

string

**pass_rate**

`passed / scored`; absent when nothing was scored.

number | null format: double

**passed**

required

integer format: int64

**scored**

required

integer format: int64

**sessions**

required

Distinct sessions the scores read.

integer format: int64

**trend**

Daily pass rates, oldest first (agent groups only).

Array\<number>

**by_observer**

required

Array\<object>

Completed scores in one group of a live-quality summary.

object

**key**

required

An agent id, an observer id or a day (`YYYY-MM-DD`), by list.

string

**pass_rate**

`passed / scored`; absent when nothing was scored.

number | null format: double

**passed**

required

integer format: int64

**scored**

required

integer format: int64

**sessions**

required

Distinct sessions the scores read.

integer format: int64

**trend**

Daily pass rates, oldest first (agent groups only).

Array\<number>

**days**

required

integer format: int32

**pass_rate**

number | null format: double

**passed**

required

integer format: int64

**scored**

required

integer format: int64

**sessions**

required

integer format: int64

**since**

required

Start of the window.

string format: date-time

### Example

```json
{
  "by_agent": [
    {
      "key": "agent_01933b5a000070008000000000000001",
      "pass_rate": 0.92
    }
  ],
  "by_day": [
    {
      "key": "agent_01933b5a000070008000000000000001",
      "pass_rate": 0.92
    }
  ],
  "by_observer": [
    {
      "key": "agent_01933b5a000070008000000000000001",
      "pass_rate": 0.92
    }
  ],
  "days": 7,
  "pass_rate": 0.92
}
```

404Observer not found

### 404

Observer not found

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/observers/summary';
const options = {method: 'GET'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

Request

```sh
curl --request GET \
  --url https://app.everruns.com/api/v1/observers/summary
```

Additional language examples require JavaScript. The default request example is available above.

200404

200 · Success

```json
{
  "by_agent": [
    {
      "key": "agent_01933b5a000070008000000000000001",
      "pass_rate": 0.92,
      "passed": 0,
      "scored": 0,
      "sessions": 0
    }
  ],
  "by_day": [
    {
      "key": "agent_01933b5a000070008000000000000001",
      "pass_rate": 0.92,
      "passed": 0,
      "scored": 0,
      "sessions": 0
    }
  ],
  "by_observer": [
    {
      "key": "agent_01933b5a000070008000000000000001",
      "pass_rate": 0.92,
      "passed": 0,
      "scored": 0,
      "sessions": 0
    }
  ],
  "days": 7,
  "pass_rate": 0.92,
  "passed": 0,
  "scored": 0,
  "sessions": 0,
  "since": "2026-10-12T09:00:00Z"
}
```

404 · Observer not found

No response body example is declared for this status.

## Matching endpoints