from superu import SuperU

client = SuperU("YOUR_SUPERU_API_KEY")

payload = {
    "page": "1",
    "limit": "10",
    "search_query": "ava"
}

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

{
  "contact_list": [
    {
      "id": "69f9a8689a75ace1c01dc475",
      "name": "Ava Patel",
      "email": "ava.patel@example.com",
      "phone": "+1 5551234567",
      "created_at": "2026-05-05 08:20:56.125000"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total_count": 1,
    "total_pages": 1,
    "has_next": false,
    "has_prev": false
  }
}