Get an audience
GET
/v1/audiences/{audience_id}
const audience = await bird.audiences.get("adn_01krdgeqcxet5s7t44vh8rt9mg");
console.log(audience.name);audience = client.audiences.get("adn_01krdgeqcxet5s7t44vh8rt9mg")
print(audience.name)audience, err := client.Audiences.Get(context.Background(), "adn_123")
if err != nil {
log.Fatal(err)
}
fmt.Println(audience.Name)$audience = $bird->audiences->get('adn_01krdgeqcxet5s7t44vh8rt9mg');
echo $audience->getName();bird audiences get <audience-id>curl -X GET "https://us1.platform.bird.com/v1/audiences/{audience_id}" \
-H "Authorization: Bearer $TOKEN"Odpowiedź200
{
"id": "adn_01krdgeqcxet5s7t44vh8rt9mg",
"type": "static",
"created_at": "2026-05-20T09:14:52Z",
"updated_at": "2026-05-25T16:42:01Z"
}
Returns a single audience: its name, description, and type. The member list is separate; fetch it with List an audience's contacts.
Parametry
audience_id
string
ID of the audience to fetch.
Treść odpowiedzi
id
string
wymagane
ID of the audience, accepted by every operation that takes an audience_id.
name
string
wymagane
Display name for the audience.
description
nullable string
Longer description of who this audience is.
type
string
wymagane
How the audience's recipients are determined. static is an explicit member list you manage by adding and removing contacts.
Possible values: static
created_at
string
wymagane
updated_at
string
wymagane