GET
/
agents
/
{id}
curl --request GET \
  --url https://api.magebank.ai/agents/{id} \
  --header 'x-api-key: <x-api-key>'
[
  {
    "id": "agent_k77NTwxp2Ym3JCmVsKtXQA",
    "name": "Payment Assistant",
    "description": "Handles payment processing for customer support",
    "status": "active",
    "walletAddress": {
      "addressId": "0x9d20dE668c8F9fb431cf6D6BBA48ee60Fe8E2BAB",
      "networkId": "base-sepolia"
    },
    "balance": "100",
    "currency": "USDC",
    "paymentRules": {
      "dailyLimit": 1000,
      "transactionLimit": 100,
      "requireApprovalAboveAmount": 50
    },
    "tags": ["customer-support", "payments"],
    "created": "2025-04-15T11:00:08Z"
  },
  {
    "id": "agent_bRSEFnMRD1fvkMM39hzPdM",
    "name": "Marketing Budget",
    "description": "Manages marketing expenses",
    "status": "active",
    "walletAddress": {
      "addressId": "0x8c30dE668c8F9fb431cf6D6BBA48ee60Fe8E1CAB",
      "networkId": "base-sepolia"
    },
    "balance": "500",
    "currency": "USDC",
    "paymentRules": {
      "dailyLimit": 2000,
      "transactionLimit": 200
    },
    "tags": ["marketing", "subscriptions"]
  }
]

User Agents: Returns an array of agents assigned to the user based on the provided user ID.

​
Path Parameters

​
id
string
required

User ID in the format user_xxx

​
Request Headers

​
x-api-key
string
required

Your API key for authentication

​
Response

Returns an array of agent objects, each containing:

​
id
string

Unique agent identifier

​
name
string

Name of the agent

​
description
string

Purpose and functionality of the agent

​
status
string

Current status of the agent (active, inactive, paused)

​
walletAddress
object
​
balance
string

Current balance of the agent

​
currency
string

Currency type used

​
paymentRules
object
​
tags
array

Categories or labels assigned to the agent

​
created
string

Timestamp when the agent was created

[
  {
    "id": "agent_k77NTwxp2Ym3JCmVsKtXQA",
    "name": "Payment Assistant",
    "description": "Handles payment processing for customer support",
    "status": "active",
    "walletAddress": {
      "addressId": "0x9d20dE668c8F9fb431cf6D6BBA48ee60Fe8E2BAB",
      "networkId": "base-sepolia"
    },
    "balance": "100",
    "currency": "USDC",
    "paymentRules": {
      "dailyLimit": 1000,
      "transactionLimit": 100,
      "requireApprovalAboveAmount": 50
    },
    "tags": ["customer-support", "payments"],
    "created": "2025-04-15T11:00:08Z"
  },
  {
    "id": "agent_bRSEFnMRD1fvkMM39hzPdM",
    "name": "Marketing Budget",
    "description": "Manages marketing expenses",
    "status": "active",
    "walletAddress": {
      "addressId": "0x8c30dE668c8F9fb431cf6D6BBA48ee60Fe8E1CAB",
      "networkId": "base-sepolia"
    },
    "balance": "500",
    "currency": "USDC",
    "paymentRules": {
      "dailyLimit": 2000,
      "transactionLimit": 200
    },
    "tags": ["marketing", "subscriptions"]
  }
]

​
Status Codes

Status CodeDescription
200List of agents successfully retrieved (may be empty)
500Internal Server Error

Empty Response: If the user has no agents, an empty array will be returned with a 200 status code.