List computed traits
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. 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.
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.
Token-based pagination via pageSize and pageToken (see meta.nextToken).
Optional
Only computed traits writing to this store
mem_store_01h9d8r0vte3hz8tykdj329t7rPattern: ^mem_store_[a-zA-Z0-9]{26}$Min length: 36Max length: 36Optional
Only computed traits referencing this definition
twilio.frequency_capPattern: ^twilio\.[a-z0-9_]+$Max length: 128Optional
Exact-match filter on the effective trait key
SendIntelligence.weeklyCapMax length: 256Optional
Only enabled, or only disabled, computed traits
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.
^[a-zA-Z0-9._~-]+:[a-zA-Z0-9._~-]+(,[a-zA-Z0-9._~-]+:[a-zA-Z0-9._~-]+)*$Optional
Maximum number of items to return in a single response. Must be between 1 and 100. Defaults to 20 when omitted.
20Minimum: 1Maximum: 100Optional
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.
500OK - A page of computed traits
Optional
List of computed traits
100Optional
Pagination metadata for list responses
1curl -X GET "https://audiences.twilio.com/preview/ComputedTraits?PageSize=20" \2-u $TWILIO_API_KEY:$TWILIO_API_SECRET
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": 715},16"traitKey": "SendIntelligence.weeklyCap"17},18"isEnabled": true,19"traitKey": "SendIntelligence.weeklyCap",20"parameters": {21"windowDays": 7,22"maxSends": 523},24"createdAt": "2026-09-16T14:22:40Z",25"updatedAt": "2026-09-16T14:22:40Z"26}27],28"meta": {29"key": "computedTraits",30"pageSize": 131}32}