---
title: "Retrieve list of audience attributes"
method: GET
path: "/audiences/{audienceId}/attributes"
tags: ["Parent Segment Configurations"]
---

# Retrieve list of audience attributes

`GET /audiences/{audienceId}/attributes`

Retrieve a list of parent segment attributes. You can also specify the visibility level for sensitive attributes.

## Path parameters

- `audienceId` integer, required

## Response `200`

successful operation

- union[]
  - union
    - AudienceAttributeWithVisibility
      - `audienceId` string, required — ID of Master Segment for this attribute
      - `id` string, nullable — This can be null when the attribute is an enriched attribute
      - `name` string, required — Column name user defined on Master Segment Configuration page of Data Workbench
      - `type` 'string' | 'number' | 'timestamp' | 'date' | 'string_array' | 'number_array' | 'boolean', required — Type of the column
      - `parentDatabaseName` string, required — Database name of the attribute table
      - `parentTableName` string, required — Table name of the attribute table
      - `parentColumn` string, required — Column name of the attribute table which is imported into customer table
      - `parentKey` string, nullable, required — Join key of the attribute table (This can be null when the attribute is an enriched attribute)
      - `foreignKey` string, nullable, required — Foreign key of the master table (This can be null when the attribute is an enriched attribute)
      - `matrixColumnName` string
      - `matrixColumnDescription` string, nullable — Description of the column in attribute table
      - `usedBySegmentInsight` boolean
      - `groupingName` string, nullable — Group name of the attribute
      - `visibility` 'clear' | 'pii' | 'non_pii' | 'blocked'
    - AudienceMasterAttribute — Attribute of master table, not attribute tables. Similar to AudienceAttribute but some properties are null
      - `name` string, required — Column name user defined on Master Segment Configuration page of Data Workbench
      - `type` 'string' | 'number' | 'timestamp' | 'date' | 'string_array' | 'number_array' | 'boolean', required — Type of the column
      - `parentDatabaseName` string — Database name of the attribute table
      - `parentTableName` string — Table name of the attribute table
      - `parentColumn` string, required — Column name of the attribute table which is imported into customer table
      - `parentKey` string — Join key of the attribute table
      - `foreignKey` string — Foreign key of the master table

## Other responses

- `400` — Given parameters are not valid
- `401` — Unauthorized; You don't provide valid credentials. Maybe you didn't specify valid TD's Master API Key as 'TD1 {Your TD Master API Key}'.
- `403` — Requested resource or action is not allowed because you don't have sufficient permissions
- `404` — The specified resource was not found
- `4XX` — There is a high possibility of error of the authentication system. Please check the contents and authority of the key. Please contact the TD support team if you do not resolve it.
- `5XX` — System error. Because there is a possibility of a temporary error due to network trouble and so on, we recommend several times retry on request side. Please contact the TD support team if you do not resolve it.

---

[API](https://skmtc.net/treasure/apis/cdp-api.md) · [All operations](https://skmtc.net/treasure/apis/cdp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treasure/cdp-api/revisions/24caa8eb809b/schema)