---
title: "GET /data/v1/objects/{object_name}/attributes"
method: GET
path: "/data/v1/objects/{object_name}/attributes"
tags: ["Data", "Object Attributes"]
---

# GET /data/v1/objects/{object_name}/attributes

`GET /data/v1/objects/{object_name}/attributes`

## Path parameters

- `object_name` string, required

## Response `200`

Response for a successful list operation.

- object — Response for a successful list operation.
  - `status` 'success', required
  - `data` UObjectsUAttribute[], required
    - union — Definition of an attribute on a Unify object.
      - object — Base properties that define an attribute on a Unify object.
        - `type` 'ADDRESS', required — The type of value this attribute can hold.
        - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
        - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
        - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
        - `is_required` boolean, required — Whether the attribute is required.
        - `is_unique` boolean, required — Whether the attribute is unique.
      - object — Base properties that define an attribute on a Unify object.
        - `type` 'BOOLEAN', required — The type of value this attribute can hold.
        - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
        - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
        - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
        - `is_required` boolean, required — Whether the attribute is required.
        - `is_unique` boolean, required — Whether the attribute is unique.
      - object — Base properties that define an attribute on a Unify object.
        - `type` 'COUNTRY', required — The type of value this attribute can hold.
        - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
        - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
        - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
        - `is_required` boolean, required — Whether the attribute is required.
        - `is_unique` boolean, required — Whether the attribute is unique.
      - object — Base properties that define an attribute on a Unify object.
        - `type` 'CURRENCY', required — The type of value this attribute can hold.
        - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
        - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
        - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
        - `is_required` boolean, required — Whether the attribute is required.
        - `is_unique` boolean, required — Whether the attribute is unique.
      - object — Base properties that define an attribute on a Unify object.
        - `type` 'DATE', required — The type of value this attribute can hold.
        - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
        - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
        - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
        - `is_required` boolean, required — Whether the attribute is required.
        - `is_unique` boolean, required — Whether the attribute is unique.
      - object — Base properties that define an attribute on a Unify object.
        - `type` 'DATETIME', required — The type of value this attribute can hold.
        - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
        - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
        - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
        - `is_required` boolean, required — Whether the attribute is required.
        - `is_unique` boolean, required — Whether the attribute is unique.
      - object — Base properties that define an attribute on a Unify object.
        - `type` 'DECIMAL', required — The type of value this attribute can hold.
        - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
        - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
        - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
        - `is_required` boolean, required — Whether the attribute is required.
        - `is_unique` boolean, required — Whether the attribute is unique.
      - object — Base properties that define an attribute on a Unify object.
        - `type` 'EMAIL_ADDRESS', required — The type of value this attribute can hold.
        - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
        - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
        - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
        - `is_required` boolean, required — Whether the attribute is required.
        - `is_unique` boolean, required — Whether the attribute is unique.
      - object — Base properties that define an attribute on a Unify object.
        - `type` 'INTEGER', required — The type of value this attribute can hold.
        - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
        - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
        - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
        - `is_required` boolean, required — Whether the attribute is required.
        - `is_unique` boolean, required — Whether the attribute is unique.
      - UObjectsUMultiSelectAttribute — Base properties that define an attribute on a Unify object.
        - `type` 'MULTI_SELECT', required — The type of value this attribute can hold.
        - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
        - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
        - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
        - `is_required` boolean, required — Whether the attribute is required.
        - `is_unique` boolean, required — Whether the attribute is unique.
      - object — Base properties that define an attribute on a Unify object.
        - `type` 'PHONE_NUMBER', required — The type of value this attribute can hold.
        - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
        - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
        - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
        - `is_required` boolean, required — Whether the attribute is required.
        - `is_unique` boolean, required — Whether the attribute is unique.
      - UObjectsUReferenceAttribute — Base properties that define an attribute on a Unify object.
        - `type` 'REFERENCE', required — The type of value this attribute can hold.
        - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
        - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
        - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
        - `is_required` boolean, required — Whether the attribute is required.
        - `is_unique` boolean, required — Whether the attribute is unique.
      - UObjectsUSelectAttribute — Base properties that define an attribute on a Unify object.
        - `type` 'SELECT', required — The type of value this attribute can hold.
        - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
        - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
        - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
        - `is_required` boolean, required — Whether the attribute is required.
        - `is_unique` boolean, required — Whether the attribute is unique.
      - object — Base properties that define an attribute on a Unify object.
        - `type` 'TEXT', required — The type of value this attribute can hold.
        - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
        - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
        - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
        - `is_required` boolean, required — Whether the attribute is required.
        - `is_unique` boolean, required — Whether the attribute is unique.
      - object — Base properties that define an attribute on a Unify object.
        - `type` 'URL', required — The type of value this attribute can hold.
        - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
        - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
        - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
        - `is_required` boolean, required — Whether the attribute is required.
        - `is_unique` boolean, required — Whether the attribute is unique.
      - object — Base properties that define an attribute on a Unify object.
        - `type` 'UUID', required — The type of value this attribute can hold.
        - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
        - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
        - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
        - `is_required` boolean, required — Whether the attribute is required.
        - `is_unique` boolean, required — Whether the attribute is unique.

## Other responses

- `400` — Response for any operation that results in a bad request error.
- `401` — Response for any operation that results in an unauthorized error.
- `404` — Response for any operation that results in a not found error.
- `500` — Response for any operation that results in an internal server error.

## Changes

- **2026-04-14** `8f2318f5f13a` — 6 breaking, 7 info
  - the response property `data/items/anyOf[#/components/schemas/UObjects.UMultiSelectAttribute]/allOf[subschema #1]/description` became nullable for the status `200`
  - the response property `data/items/anyOf[#/components/schemas/UObjects.UReferenceAttribute]/allOf[subschema #1]/description` became nullable for the status `200`
  - the response property `data/items/anyOf[#/components/schemas/UObjects.UReferenceAttribute]/related_attribute` became nullable for the status `200`
  - the response property `data/items/anyOf[#/components/schemas/UObjects.USelectAttribute]/allOf[subschema #1]/description` became nullable for the status `200`
  - …9 more
- **2026-04-13** `6c8df028bd7e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/unifygtm/apis/unify-api/changes/data/v1/objects/:object_name/attributes/get.md)

---

[API](https://skmtc.dev/unifygtm/apis/unify-api.md) · [All operations](https://skmtc.dev/unifygtm/apis/unify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unifygtm/unify-api/revisions/832b8061b7a4/schema)
