Get a catalog item

Retrieve one item owned by the authenticated merchant, including an archived item.

GET/api/items/{item_id}

Read one owned item, including archived items. Requires merchant-id and signature headers.

Request fields from the OpenAPI specification
Field	Type	Required	Description
`item_id`path	string	Yes	Catalog item UUID.

Source: download OpenAPI 3.1. Examples below use illustrative values.

Example response

{
  "id": "11111111-1111-4111-8111-111111111111",
  "merchant_id": "33333333-3333-4333-8333-333333333333",
  "name": "Example item",
  "amount": "19.95",
  "currency": "USD",
  "description": null,
  "icon_url": null,
  "success_url": null,
  "archived_at": null,
  "created_at": "2026-10-24T12:00:00.000Z",
  "updated_at": "2026-10-24T12:00:00.000Z"
}

The path ID must be a UUID. A missing item and an item belonging to another merchant both return 404 ITEM_NOT_FOUND.

An archived item remains readable, but cannot be used for a new invoice from item. archived_at contains the archival timestamp when archived.

Sign {} for the bodyless GET. The item ID is in the path and is not included in the current signature payload.

Example responseCopy Anchor Link

On this page

Example response