---
title: "Agents that have used this workspace, busiest first"
method: GET
path: "/v1/agents"
tags: ["Agents"]
---

# Agents that have used this workspace, busiest first

`GET /v1/agents`

## Request

- Base URL: `https://ratchetgate.com`
- URL: `https://ratchetgate.com/v1/agents`
- Auth: HTTP bearer

## Query parameters

- `days` integer

## Response `200`

Default Response

- object
  - `data` object[]
    - `agent_id` string
    - `effects` integer
    - `concluded` integer: Effects that ended, and the denominator report_rate was computed over.
    - `report_rate` number, nullable: Share of concluded effects this agent reported an outcome for. null below the volume floor, where the figure would be noise.
    - `last_seen` string
  - `window` object
    - `days` integer

## Other responses

- `400`: Invalid request.
- `401`: Missing or invalid API key.
- `402`: Insufficient prepaid credit.
- `403`: Scope, policy, or budget refusal.
- `404`: Not found.
- `409`: Conflicting state or idempotency-key reuse.
- `413`: Payload too large.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/ratchetgate/apis/ratchet-api.md) · [All operations](https://skmtc.dev/ratchetgate/apis/ratchet-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ratchetgate/apis/ratchet-api/revisions/5712f33c692f?raw)