---
title: "List Agents"
method: GET
path: "/api/v1/agent/list"
tags: ["Campaign Agent"]
---

# List Agents

`GET /api/v1/agent/list`

## Request

- Base URL: `https://api.adrex.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.adrex.ai/api/v1/agent/list`
- Auth: HTTP bearer

Every agent belonging to the current user.

## Response `200`

Successful Response

- AgentConfigResponse[]
  - `id` integer, required
  - `name` string
  - `user_id` integer, nullable
  - `is_enabled` boolean
  - `interval_minutes` integer
  - `allowed_actions` string[]: What the agent may do: 'budget' to change daily budgets, 'pause' to pause campaigns.
  - `max_budget_change_percent` number
  - `min_budget` number
  - `max_budget` number
  - `require_approval` boolean
  - `target_campaign_ids` string[], nullable: Limit the agent to these campaigns. None means every campaign on connected accounts.
  - `target_cpa` number, nullable
  - `target_roas` number, nullable
  - `budget_currency` string, nullable: ISO code the budget limits and target CPA were entered in. Recorded so a later account in a different currency cannot silently reinterpret them — 10000 meant as dollars is a crippling ceiling read as rupees.
  - `business_context` string, nullable
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable

---

[API](https://skmtc.dev/adrex/apis/adrex-ai.md) · [All operations](https://skmtc.dev/adrex/apis/adrex-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/adrex/apis/adrex-ai/revisions/4e6f0f0bc902?raw)