Retrieve Profiles API token by ID

Request

Retrieve a specific Profiles API token by its identifier.

Security

TdApikeyAuth

Path

audienceIdinteger, (int64)required

Master Segment ID of the token

tokenIdinteger, (int64)required

ID of Token to return

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

Responses

successful operation

Bodyapplication/json

idstring, (integer)

audienceIdstring, (integer)

tokenstring, (uuid)

UUID of the token

descriptionstring

keyColumnstring

A key column name to fetch the information of a customer.

Example:"td_client_id"

segmentsArray of objects(SegmentSummary)

associated segments

attributeColumnsArray of strings

associated attribute column names.

Example:

[
  "gender",
  "country"
]

v2boolean

whether the token is v2 or not

Example:true

createdAtstring, (date-time)

updatedAtstring, (date-time)

createdByobject(User)

updatedByobject(User)

Response

{
  "id": "string",
  "audienceId": "string",
  "token": "b5507016-7da2-4777-a161-1e8042a6a377",
  "description": "string",
  "keyColumn": "td_client_id",
  "segments": [
    { … }
  ],
  "attributeColumns": [
    "gender",
    "country"
  ],
  "v2": true,
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "createdBy": {
    "id": "string",
    "td_user_id": "string",
    "name": "string"
  },
  "updatedBy": {
    "id": "string",
    "td_user_id": "string",
    "name": "string"
  }
}