Skip to main content
GET
/
agents
List agents
curl --request GET \
  --url https://api.useproxy.ai/v1/agents \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "status": "active",
      "customerId": "<string>",
      "externalId": "<string>",
      "limits": {
        "amount": 123,
        "currency": "<string>",
        "interval": "<string>"
      },
      "policy": {
        "requireIntent": true,
        "requireAttestation": true,
        "requireApproval": true,
        "autoApproveBelow": 123,
        "attestationWindowMinutes": 123,
        "cooldownMinutes": 123,
        "ttlMinutes": 123,
        "ttlDays": 123,
        "limits": {
          "perAuth": 123,
          "perDay": 123,
          "perMonth": 123
        },
        "allowedMccs": [
          "<string>"
        ],
        "blockedMccs": [
          "<string>"
        ],
        "allowedMerchants": [
          "<string>"
        ],
        "lockToFirstMerchant": true
      },
      "metadata": {},
      "createdAt": "2023-11-07T05:31:56Z"
    }
  ],
  "nextCursor": "<string>"
}

Authorizations

Authorization
string
header
required

API key authentication. Include your API key in the Authorization header as Bearer <api_key>.

Query Parameters

customerId
string

Filter by customer ID

limit
integer
default:50

Maximum number of results to return (default: 50)

Required range: 1 <= x <= 100
cursor
string

Pagination cursor for fetching the next page

Response

List of agents

data
object[]
required
nextCursor
string | null