---
title: "Retrieve Product attributes"
method: GET
path: "/v1/products/attributes"
tags: ["Products"]
---

# Retrieve Product attributes

`GET /v1/products/attributes`

## Request

- Base URL: `https://api.jasper.ai`
- URL: `https://api.jasper.ai/v1/products/attributes`
- Auth: one of:
  - API key in header `X-API-Key`
  - OAuth 2
    - Authorization code: `https://api.jasper.ai/oauth2/authorize`
    - Token URL: `https://api.jasper.ai/oauth2/token` scopes: `user`

Retrieve the attributes in your Product Schema.

## Response `200`

List of product attributes

- ProductAttributesResponseDto
  - `requestId` string, required
  - `resource` string, required
  - `data` ProductAttributeData[], required
    - `id` string, required: The unique attribute ID.
    - `name` string, required: The attribute name.
    - `description` object, nullable: Optional attribute description.
    - `type` 'TEXT_SHORT' | 'TEXT_LONG' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'ENUM' | 'KEY_VALUE' | 'JSON' | 'CONTEXT_SOURCE_LIST', required: The normalized core value type. A list-mode attribute (e.g. a multi-select, or a "list of numbers") reports its element type here plus `list: true` — `ARRAY` / `MULTI_SELECT` are never reported directly.
    - `isList` boolean, required: Whether the attribute holds a list of values (send/receive an array) rather than a single value.
    - `options` ProductAttributeOptionData[]: Selectable options — present only for `ENUM` attributes (single- and multi-select).
      - `value` string, required: The option label. Set enum / multi-select values (and categories) by this label.
    - `keys` string[]: Predefined keys — present only for `KEY_VALUE` attributes. An empty array means keys are free-form (the extraction model infers them).

## Other responses

- `401`: Unauthorized access to the workspace.
- `403`: Product IQ is not enabled for this workspace.
- `500`: Internal server error. Unable to get product attributes.

## Changes

- **2026-11-03** `3d5be7408661`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/jasper/apis/jasper-api/changes/v1/products/attributes/get.md)

---

[API](https://skmtc.dev/jasper/apis/jasper-api.md) - [All operations](https://skmtc.dev/jasper/apis/jasper-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jasper/apis/jasper-api/revisions/3d5be7408661?raw)