Skip to content

Parent Segments

After you have created the parent segment, you can view data about the parent segment, such as details about a single segment, audience data, the list of segment folders it contains, or a list of parent segments available.

Retrieve list of segment folders

Request

Retrieve a list of segment folders based on a parent segment's identifier.

Security
TdApikeyAuth
Path
audienceIdinteger, (int64)required

Master segment ID

curl -i -X GET \
  'https://api-cdp.treasuredata.com/audiences/{audienceId}/folders' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Retrieves a list of segment folders.

N.B. that createdAt can be null, meaning that it is not known which user created the folder.

N.B. that updatedAt can be null, meaning that is is not known which user last updated the folder.

Bodyapplication/json
Array [
idstring[1-9][0-9]*
audienceIdstring[1-9][0-9]*

ID of the parent audience. For composable folders this carries the composable audience id; the complete-vs-composable discriminator lives on the parent audience entity, not on the folder.

namestring
descriptionstring or null
createdAtstring, (date-time)
updatedAtstring, (date-time)
createdByUser (object) or (NullValue (object or null))
One of:
updatedByUser (object) or (NullValue (object or null))
One of:
]
Response
[ { "id": "string", "audienceId": "string", "name": "string", "description": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "createdBy": {}, "updatedBy": {} } ]