---
title: "Read a commerce item"
method: GET
path: "/commerce/items/{itemId}"
tags: ["Commerce"]
---

# Read a commerce item

`GET /commerce/items/{itemId}`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/commerce/items/{itemId}`
- Auth: HTTP bearer

Requires `commerce:items:read`.

## Path parameters

- `itemId` string, required

## Response `200`

Commerce item

- CommerceItemResponse
  - `item` CommerceItem, required
    - `itemId` string, required
    - `tenantId` string, required
    - `name` string, required
    - `description` string
    - `amountMinor` integer, required
    - `currency` string, required
    - `active` boolean, required
    - `scope` 'global' | 'property', required
    - `propertyId` string
    - `allowQuantity` boolean, required
    - `minQuantity` integer, required
    - `maxQuantity` integer, required
    - `fields` CommerceItemField[], required
      - `key` string, required
      - `label` string, required
      - `type` 'text' | 'number' | 'email' | 'phone' | 'date' | 'select', required
      - `required` boolean, required
      - `options` string[]
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `default`: Structured error

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)