Get attribute definition
Get the specified attribute definition from the schema given its key.
Authorizations
Path parameters
workspaceIdstring · uuidRequiredExample:
Your workspace identifier.
b4e02c85-c6d2-4b15-8885-e09671799c61
attributeDefinitionKeystringRequiredExample:
The key of an attribute definition.
company
Responses
200
The attribute definition was returned successfully.
application/json
404
The workspace or attribute definition key was not found.
application/json
get
GET /workspaces/{workspaceId}/attribute-definitions/{attributeDefinitionKey} HTTP/1.1
Host: api.bird.com
Authorization: Bearer JWT
Accept: */*
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"key": "countryCode",
"displayName": "Country Code",
"description": "The country code of the contact.",
"cardinality": "one",
"type": "boolean",
"format": {
"type": "emailAddress"
},
"pii": false,
"readOnly": false,
"builtin": false,
"archived": false,
"indexMapping": {
"fields": [
{
"name": "emailaddress-standard",
"analyzer": "simple",
"type": "string"
}
]
},
"createdAt": "2025-07-01T17:48:37.538Z",
"updatedAt": "2025-07-01T17:48:37.538Z",
"version": 1,
"acl": [
{
"roleId": "123e4567-e89b-12d3-a456-426614174000",
"read": true,
"write": true
}
]
}
Examples
Let's establish some of our data that will be used in the following examples:
Workspace ID: a1405560-c8d3-4b1a-877d-3f449ad95352
AccessKey: abcd
Attribute Definition Key: countryCode
Get an attribute definition
In this example, we're fetching the attribute definition by its key.
curl -X GET "https://api.bird.com/workspaces/a1405560-c8d3-4b1a-877d-3f449ad95352/attribute-definitions/countryCode" \
-H "Authorization: AccessKey abcd" \
-H "Content-Type: application/json" \
Last updated
Was this helpful?