Skip to main content
GET
https://api.unify.ai
/
v0
/
assistant
curl --request GET \
  --url 'https://api.unify.ai/v0/assistant?phone=None&email=None' \
  --header "Authorization: Bearer $UNIFY_KEY"

{
    "info": [
        {
            "agent_id": "123",
            "first_name": "Alice",
            "surname": "Smith",
            "age": 25,
            "weekly_limit": 40.0,
            "max_parallel": 3,
            "phone": "+1-555-123-4567",
            "email": "[email protected]",
            "nationality": "United States",
            "profile_photo": "https://example.com/photos/alice.jpg",
            "profile_video": "https://example.com/videos/alice.mp4",
            "about": "Mathematician and writer known for work on Analytical Engine",
            "voice_id": "bf0a246a-8642-498a-9950-80c35e9276b5",
            "voice_provider": "cartesia",
            "voice_mode": "tts",
            "phone_country": "US",
            "timezone": "America/New_York",
            "created_at": "2025-04-25T12:00:00Z",
            "updated_at": "2025-04-25T12:00:00Z"
        },
        {
            "agent_id": "456",
            "first_name": "Bob",
            "surname": "Jones",
            "age": 30,
            "weekly_limit": 35.5,
            "max_parallel": 2,
            "phone": "+1-555-987-6543",
            "email": "[email protected]",
            "nationality": "Mexico",
            "profile_photo": "https://example.com/photos/bob.jpg",
            "profile_video": "https://example.com/videos/bob.mp4",
            "about": "Machine learning expert with focus on computer vision",
            "voice_id": "bf0a246a-8642-498a-9950-80c35e9276b5",
            "voice_provider": "cartesia",
            "voice_mode": "tts",
            "phone_country": "CA",
            "timezone": "America/Vancouver",
            "created_at": "2025-04-24T10:30:00Z",
            "updated_at": "2025-04-24T10:30:00Z"
        }
    ]
}
Returns a list of all assistants belonging to the authenticated user.

​
Authorizations

​
Authorization
string
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

​
Query Parameters

​
phone
string | null
Only return assistants whose phone number matches this E.164-style value (leading ’+’ is URL-encoded).
​
email
string | null
Only return assistants whose email address matches this value.
curl --request GET \
  --url 'https://api.unify.ai/v0/assistant?phone=None&email=None' \
  --header "Authorization: Bearer $UNIFY_KEY"

{
    "info": [
        {
            "agent_id": "123",
            "first_name": "Alice",
            "surname": "Smith",
            "age": 25,
            "weekly_limit": 40.0,
            "max_parallel": 3,
            "phone": "+1-555-123-4567",
            "email": "[email protected]",
            "nationality": "United States",
            "profile_photo": "https://example.com/photos/alice.jpg",
            "profile_video": "https://example.com/videos/alice.mp4",
            "about": "Mathematician and writer known for work on Analytical Engine",
            "voice_id": "bf0a246a-8642-498a-9950-80c35e9276b5",
            "voice_provider": "cartesia",
            "voice_mode": "tts",
            "phone_country": "US",
            "timezone": "America/New_York",
            "created_at": "2025-04-25T12:00:00Z",
            "updated_at": "2025-04-25T12:00:00Z"
        },
        {
            "agent_id": "456",
            "first_name": "Bob",
            "surname": "Jones",
            "age": 30,
            "weekly_limit": 35.5,
            "max_parallel": 2,
            "phone": "+1-555-987-6543",
            "email": "[email protected]",
            "nationality": "Mexico",
            "profile_photo": "https://example.com/photos/bob.jpg",
            "profile_video": "https://example.com/videos/bob.mp4",
            "about": "Machine learning expert with focus on computer vision",
            "voice_id": "bf0a246a-8642-498a-9950-80c35e9276b5",
            "voice_provider": "cartesia",
            "voice_mode": "tts",
            "phone_country": "CA",
            "timezone": "America/Vancouver",
            "created_at": "2025-04-24T10:30:00Z",
            "updated_at": "2025-04-24T10:30:00Z"
        }
    ]
}