# GET /agent-ops/registry

**Resource:** [Agent Ops](./agent-ops.md)  
**Scopes:** `agent-ops:read`  
**Write operation:** no

List all registered AI agents. Filter by agent_type or status.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `agent_type` | query | string | no | Filter by type: cron_report, real_time_responder, scheduled_task, error_handler |
| `status` | query | string | no | Filter by status: active, paused, error, disabled |
| `limit` | query | number | no | Max results (default 25) |

## Response example

```json
{
  "data": [
    {
      "id": "880b909e-aa2f-4d8c-8372-073921a9d947",
      "company_id": "ebeff86e-...",
      "name": "nurture-agent",
      "display_name": "Nurture Agent",
      "agent_type": "scheduled_task",
      "status": "active",
      "schedule": "0 6 * * *",
      "timezone": "Australia/Sydney",
      "capabilities": ["email", "sms"],
      "created_at": "2026-05-01T00:00:00Z",
      "updated_at": "2026-05-19T06:20:00Z"
    }
  ],
  "pagination": { "has_more": false }
}
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`