Skip to contentSkip to navigationSkip to topbar

List computed traits


(new)

Beta

Twilio Cohorts is currently available as a Private Beta product and the information contained in this document is subject to change. You acknowledge and agree that your use of Twilio Cohorts is subject to the terms of the Services in Private Beta(link takes you to an external page). This means that some features are not yet implemented and others may be changed before the product is declared as Generally Available. Private Beta products are not covered by the Twilio Support Terms or Twilio Service Level Agreement.

(warning)

Not a HIPAA Eligible Service or PCI Compliant

Twilio Cohorts is not a HIPAA Eligible Service or PCI compliant and should not be enabled in workflows that are subject to HIPAA or PCI.

GET/preview/ComputedTraits

Base url: https://audiences.twilio.com (base url)

Lists the computed traits configured for the account, across all stores. All filters are optional and combine with AND logic.

traitKey matches the effective key, so it finds a trait whether the key came from the definition or an override.


Pagination

pagination page anchor

Token-based pagination via pageSize and pageToken (see meta.nextToken).


Query string

list-computed-traits-query-string page anchor
Property nameTypeRequiredDescription
storeIdstring

Optional

Only computed traits writing to this store

Example: mem_store_01h9d8r0vte3hz8tykdj329t7rPattern: ^mem_store_[a-zA-Z0-9]{26}$Min length: 36Max length: 36

definitionIdstring

Optional

Only computed traits referencing this definition

Example: twilio.frequency_capPattern: ^twilio\.[a-z0-9_]+$Max length: 128

traitKeystring

Optional

Exact-match filter on the effective trait key

Example: SendIntelligence.weeklyCapMax length: 256

isEnabledboolean

Optional

Only enabled, or only disabled, computed traits


tagsstring

Optional

Match resources by one or many tags. If more than one tag is specified in the query, the search returns resources that have all the tags (AND logic).

Format: key1:value1,key2:value2

Example: tags=environment:production,campaign:q1-2026

Filter character set: tag keys and values must match [a-zA-Z0-9._~-]+ (URL-safe unreserved characters). This is the same character set enforced when tags are written, so every tag that can be stored on a resource can also be filtered on here.

Reserved (twilio__) tag keys are rejected; filter on those through their dedicated query parameters (e.g. storeType/storeId) instead.

Pattern: ^[a-zA-Z0-9._~-]+:[a-zA-Z0-9._~-]+(,[a-zA-Z0-9._~-]+:[a-zA-Z0-9._~-]+)*$

pageSizeinteger

Optional

Maximum number of items to return in a single response. Must be between 1 and 100. Defaults to 20 when omitted.

Default: 20Minimum: 1Maximum: 100

pageTokenstring

Optional

An opaque, URL-safe cursor identifying the page of results to return. Pass back meta.nextToken from a response to fetch the page after it, or meta.previousToken to fetch the page before it; a response carries a token only for a page that exists. If omitted, the API returns the first page of results.

The token's encoding and contents are an implementation detail and may change without notice, so do not decode, construct or modify one -- a malformed token is rejected. Carry it through unchanged.

Max length: 500

200400401403429500

OK - A page of computed traits

SchemaExample
Property nameTypeRequiredDescriptionChild properties
computedTraitsarray[object]

Optional

List of computed traits

Max items: 100

metaobject

Optional

Pagination metadata for list responses

List computed traitsLink to code sample: List computed traits
1
curl -X GET "https://audiences.twilio.com/preview/ComputedTraits?PageSize=20" \
2
-u $TWILIO_API_KEY:$TWILIO_API_SECRET

Response

Note about this response
1
{
2
"computedTraits": [
3
{
4
"id": "cmp_computedtrait_01h9d8r0vte3hz8tykdj329t9f",
5
"displayName": "Marketing frequency cap",
6
"description": "Whether the profile has hit its weekly marketing send cap",
7
"tags": {
8
"team": "lifecycle"
9
},
10
"storeId": "mem_store_01h9d8r0vte3hz8tykdj329t7r",
11
"definition": {
12
"definitionId": "twilio.frequency_cap",
13
"parameters": {
14
"windowDays": 7
15
},
16
"traitKey": "SendIntelligence.weeklyCap"
17
},
18
"isEnabled": true,
19
"traitKey": "SendIntelligence.weeklyCap",
20
"parameters": {
21
"windowDays": 7,
22
"maxSends": 5
23
},
24
"createdAt": "2026-09-16T14:22:40Z",
25
"updatedAt": "2026-09-16T14:22:40Z"
26
}
27
],
28
"meta": {
29
"key": "computedTraits",
30
"pageSize": 1
31
}
32
}