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

# Retrieve attribute

`GET /attributes/{companyId}/{customId}`

Returns a single attribute by `customId`.

## Path parameters

- `customId` string, required
- `companyId` string, required

## Response `200`

Successful Response

- GetAttributesResponseSchema
  - `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` — Company not found, or no attribute matches the given `customId`.
- `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)