GET
/
agentsWith
/
{id}
curl --request GET \
  --url https://api.magebank.ai/agentsWith/{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"
}

Quick Lookup: Retrieve comprehensive details about an agent using its unique ID.

​
Path Parameters

​
id
string
required

Agent ID (can be a short ID like agent_xxx)

​
Request Headers

​
x-api-key
string
required

Your API key for authentication

​
Response

​
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"
}

​
Status Codes

Status CodeDescription
200Agent details successfully retrieved
404Not Found - Agent ID doesn’t exist
500Internal Server Error

Balance Format: Balance is returned as a string to preserve precision for financial calculations.