Skip to main content
GET
/
api
/
v1
/
agents
/
{id}
curl -X GET "https://olive-gateway-a6ba.onrender.com/api/v1/agents/agent_abc123" \
  -H "Authorization: Bearer olive_live_xxx"
{
  "agent": {
    "id": "agent_abc123",
    "type": "super_agent",
    "business_name": "ABC Money Services",
    "first_name": "John",
    "last_name": "Doe",
    "phone_number": "+23277123456",
    "email": "john@abcmoney.sl",
    "location": "Freetown CBD",
    "status": "active",
    "float_balance": 5000000,
    "float_balance_formatted": "5,000,000.00 SLE",
    "commission_tier": "premium",
    "settlement_mode": "instant",
    "sub_agent_count": 12,
    "created_at": "2025-01-01T10:00:00Z"
  }
}

Request

Authorization
string
required
Bearer olive_live_xxx or Bearer eyJ... (JWT)

Path Parameters

id
string
required
Agent UUID (e.g., agent_abc123)

Response

agent
object

Examples

curl -X GET "https://olive-gateway-a6ba.onrender.com/api/v1/agents/agent_abc123" \
  -H "Authorization: Bearer olive_live_xxx"
{
  "agent": {
    "id": "agent_abc123",
    "type": "super_agent",
    "business_name": "ABC Money Services",
    "first_name": "John",
    "last_name": "Doe",
    "phone_number": "+23277123456",
    "email": "john@abcmoney.sl",
    "location": "Freetown CBD",
    "status": "active",
    "float_balance": 5000000,
    "float_balance_formatted": "5,000,000.00 SLE",
    "commission_tier": "premium",
    "settlement_mode": "instant",
    "sub_agent_count": 12,
    "created_at": "2025-01-01T10:00:00Z"
  }
}

Errors

StatusCodeDescription
401UNAUTHORIZEDInvalid API key
403FORBIDDENNot authorized to view this agent
404NOT_FOUNDAgent not found
500INTERNAL_ERRORServer error