from superu import SuperU

client = SuperU("YOUR_SUPERU_API_KEY")

payload = {
    "page": 1,
    "limit": 20,
    "search_query": ""
}

response = client.agents.list(**payload)
print(response)

curl --request POST \\
  --url https://voip-middlware.superu.ai/agent/list?page=1&limit=20 \\
  --header 'superU-Api-Key: YOUR_SUPERU_API_KEY' \\
  --data '{
  "search_query": ""
}'

{
  "agents": [
    {
      "id": "699702113f3323a52636240b",
      "name": "Hospitality Reservation Booking Agent",
      "status": "active",
      "voice_id": "CwhRBWXzGAHq8TQ4Fs17",
      "industry": "Hospitality",
      "useCase": "Spa Reservations",
      "type": "inbound",
      "created_date": "2026-02-19",
      "assistant_id": "d4afb99c-fb12-40bb-8cea-9d7bba7bf176",
      "first_message": "Hello, this is OceanVista Resort and Spa. I can help you with bookings, changes, or any questions. How would you like me to help you today?"
    }
  ],
  "pagination": {
    "total_agents": 1,
    "current_page": 1,
    "total_pages": 1,
    "items_per_page": 1,
    "has_next": false,
    "has_previous": false
  }
}

{
  "status": "error",
  "code": "BAD_REQUEST",
  "message": "Request validation failed."
}

{
  "status": "error",
  "code": "UNAUTHORIZED",
  "message": "Invalid or missing superU-Api-Key."
}

{
  "status": "error",
  "code": "NOT_FOUND",
  "message": "Resource not found."
}

{
  "status": "error",
  "code": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected server error occurred."
}

{
  "status": "error",
  "code": "NOT_IMPLEMENTED",
  "message": "This endpoint is not implemented for your workspace."
}