---
title: "List attributes"
method: GET
path: "/attributes/{companyId}"
tags: ["Attributes"]
---

# List attributes

`GET /attributes/{companyId}`

Returns all attributes configured for a company, including their `values` when the attribute is of type `list`.

## Path parameters

- `companyId` string, required

## Response `200`

Successful Response

- ListAttributesResponseSchema
  - `data` GetAttributesResponseSchema[], required — All attributes of the company.
    - `customId` string, nullable — Your own unique ID for the attribute. If omitted, Embat auto-generates one.
    - `source` 'erp' | 'api' | 'embat'
    - `active` boolean — Whether the attribute is active.
    - `name` string, required — Display name of the attribute.
    - `type` 'list' | 'string' | 'number'
    - `required` boolean — Whether a value for this attribute should be mandatory wherever it is used. Informational only: this API does not enforce it.
    - `values` AttributesResponseValuesSchema[], nullable — Values available for this attribute.
      - `customId` string, nullable — Your own unique ID for the value. If omitted, Embat auto-generates one.
      - `id` string, required — Embat ID of the value.
      - `name` string, required — Display name of the value.
      - `parentCustomId` string, nullable — Custom ID of the value, within the parent attribute (see the attribute's `parentCustomId`), that this value is nested under.
      - `parentId` string, nullable — Embat ID of the parent value. Only present when `parentCustomId` matched an existing value of the parent attribute at the time this value was saved.
    - `parentCustomId` string, nullable — Custom ID of the parent attribute this attribute is nested under.
    - `id` string, required — Embat attribute ID.
    - `createdAt` string, date-time, required — Creation date of the attribute.
    - `updatedAt` string, date-time, required — Last modification date of the attribute.
    - `parentId` string, nullable — Embat ID of the parent attribute. Only present when the attribute is nested under another one via `parentCustomId`.
    - `companyId` string, required — Embat company ID. You can get them from "companies" endpoints

## Other responses

- `401` — Unauthorized. The bearer token is missing, invalid or expired.
- `404` — Not found. The requested resource or `companyId` does not exist.
- `422` — Validation Error

---

[API](https://skmtc.net/embat/apis/embat-api.md) · [All operations](https://skmtc.net/embat/apis/embat-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/embat/embat-api/versions/36ca48bf4489/schema)