Get a label
GET
/v1/labels/{label_id}const label = await bird.labels.get("lbl_01krdgeqcxet5s7t44vh8rt9mg");
console.log(label.name, label.description);label = client.labels.get("lbl_01krdgeqcxet5s7t44vh8rt9mg")
print(label.name, label.description)label, err := client.Labels.Get(context.Background(), "lbl_01krdgeqcxet5s7t44vh8rt9mg")
if err != nil {
log.Fatal(err)
}
fmt.Println(label.Name)$label = $bird->labels->get('lbl_01krdgeqcxet5s7t44vh8rt9mg');
echo $label->getName(), ' ', $label->getDescription();bird labels get <label-id>curl -X GET "https://us1.platform.bird.com/v1/labels/{label_id}" \
-H "Authorization: Bearer $TOKEN"Risposta200
{
"id": "lbl_01krdgeqcxet5s7t44vh8rt9mg",
"name": "Hot lead",
"color": "#E5484D",
"description": "Inbound sales enquiry from a company. Not support requests or vendors.",
"created_at": "2026-05-20T09:14:52Z",
"updated_at": "2026-05-25T16:42:01Z"
}
Returns one label from the workspace's catalogue.
Parametri
label_idstringThe catalogue label to act on.
Payload di risposta
idstring
obbligatorio
ID of the label, accepted by every operation that takes a label_id. It stays the same when the label is renamed.
namestring
obbligatorio
The label name, unique in the workspace regardless of case. No commas, control characters, or leading or trailing whitespace. System names such as inbox, sent, unread, open or assigned are reserved.
colornullable string
obbligatorio
The label colour as a #RRGGBB hex value, or null when none is set.
descriptionnullable string
obbligatorio
When to apply the label, or null when none is set.
created_atstring
obbligatorio
updated_atstring
obbligatorio
Risorse correlate
Continua con la documentazione, le guide e gli esempi per questo argomento.