Python
from superu import SuperU
client = SuperU("YOUR_SUPERU_API_KEY")
audience_id = "597b3dde-9169-4017-800d-f97a5fabebe3"
response = client.audience.get(audience_id)
print(response)curl --request GET \\
--url https://voip-middlware.superu.ai/audience/597b3dde-9169-4017-800d-f97a5fabebe3 \\
--header 'superU-Api-Key: YOUR_SUPERU_API_KEY'{
"audience_id": "597b3dde-9169-4017-800d-f97a5fabebe3",
"audience_name": "Demo Audience",
"audience_description": "Leads from webinar",
"created_by_user_id": "user_32UrXxvrVxWSYp1dGLsPdElDtRt",
"created_at": "2026-05-05 08:26:09",
"contacts": [
{
"first_name": "Ava",
"last_name": "Patel",
"name": "Ava Patel",
"email": "ava.patel@example.com",
"country_code": "+1",
"phone_number": "5551234567",
"phoneNumber": "+1 5551234567",
"id": "69f9a9a1c2647606b8c43154",
"salutation": ""
}
],
"total_contacts": 1
}{
"status": "error",
"code": "BAD_REQUEST",
"message": "Request validation failed."
}{
"status": "error",
"code": "UNAUTHORIZED",
"message": "Invalid or missing superU-Api-Key."
}{
"message": "Invalid request payload",
"status": "error",
"error": "Bad Request",
"code": "BAD_REQUEST"
}{
"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."
}Audiences
Get audience
Returns detailed audience data.
GET
/
audience
/
{audience_id}
Python
from superu import SuperU
client = SuperU("YOUR_SUPERU_API_KEY")
audience_id = "597b3dde-9169-4017-800d-f97a5fabebe3"
response = client.audience.get(audience_id)
print(response)curl --request GET \\
--url https://voip-middlware.superu.ai/audience/597b3dde-9169-4017-800d-f97a5fabebe3 \\
--header 'superU-Api-Key: YOUR_SUPERU_API_KEY'{
"audience_id": "597b3dde-9169-4017-800d-f97a5fabebe3",
"audience_name": "Demo Audience",
"audience_description": "Leads from webinar",
"created_by_user_id": "user_32UrXxvrVxWSYp1dGLsPdElDtRt",
"created_at": "2026-05-05 08:26:09",
"contacts": [
{
"first_name": "Ava",
"last_name": "Patel",
"name": "Ava Patel",
"email": "ava.patel@example.com",
"country_code": "+1",
"phone_number": "5551234567",
"phoneNumber": "+1 5551234567",
"id": "69f9a9a1c2647606b8c43154",
"salutation": ""
}
],
"total_contacts": 1
}{
"status": "error",
"code": "BAD_REQUEST",
"message": "Request validation failed."
}{
"status": "error",
"code": "UNAUTHORIZED",
"message": "Invalid or missing superU-Api-Key."
}{
"message": "Invalid request payload",
"status": "error",
"error": "Bad Request",
"code": "BAD_REQUEST"
}{
"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."
}Authorizations
Your SuperU API key.
Path Parameters
Audience ID
Example:
"597b3dde-9169-4017-800d-f97a5fabebe3"
Response
Audience details

