v3

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-08-014669239.7 KB
Traits

List Profile Traits

Return a paginated, optionally filtered list of individual traits for a profile (flattened view). This is useful for UIs or tools that need to browse trait metadata (names, groups, timestamps). Use the optional traitGroups filter to scope results and the paging parameters to iterate through larger sets.

get/v1/Stores/{storeId}/Profiles/{profileId}/Traits

Query parameters

pageSizeinteger

The maximum number of items to return per page, maximum of 1000.

pageTokenstring

The token for the page of results to retrieve.

orderBy'ASC' | 'DESC'

Either 'ASC' or 'DESC' to sort results ascending or descending respectively.

traitGroupsstring
Example:Contact

Comma separated list of trait group names to include.

Response

A list of traits.

Example response

{
  "traits": [
    {
      "name": "firstName",
      "traitGroup": "Contact",
      "timestamp": "2025-01-01T12:00:00Z"
    }
  ],
  "meta": {
    "key": "profiles",
    "nextToken": "eyJlYXN0ZXIiOiJlZ2cifQ",
    "previousToken": "eyJlYXN0ZXIiOiJlZ2cifQ"
  }
}