items

Detail /items/{uuid}

Get one item by UUID (/items/{uuid}). Returns record with pricing, tax, unit, category, manufacturer, flags, balances, and organization when applicable. Reference entities use UUIDs only.

GET

/items/{uuid}

curl --request GET \
  --url 'https://default.hannacrm.app/api/v4/items/{uuid}?fields=%3Cstring%3E' \
  --header 'Authorization: Bearer <token>'

{
  "record": {
    "active": "<string>",
    "balance": "<string>",
    "balance_by_warehouse": [
      {}
    ],
    "barcode": "<string>",
    "bruto": "<string>",
    "buy_rate": "<string>",
    "category": {
      "name": "<string>",
      "uuid": "<string>"
    },
    "code": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "created_by": {
      "name": "<string>",
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "custom_fields": [
      {
        "slug": "<string>",
        "value": "<any>"
      }
    ],
    "delivery_term": "<string>",
    "description": "<string>",
    "description_de": "<string>",
    "description_en": "<string>",
    "ean_code": "<string>",
    "guid": "<string>",
    "integration_code": "<string>",
    "is_archived": "<string>",
    "is_product": "<string>",
    "is_serial_required": "<string>",
    "is_service": "<string>",
    "is_visible_portal": "<string>",
    "item_weight": "<string>",
    "long_description": "<string>",
    "long_description_de": "<string>",
    "long_description_en": "<string>",
    "manufacturer": [
      {}
    ],
    "min_sell_price": "<string>",
    "neto": "<string>",
    "organization": {
      "name": "<string>",
      "uuid": "<string>"
    },
    "rate": "<string>",
    "serial_numbers": "<string>",
    "supplier": {
      "name": "<string>",
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "supplier_code": "<string>",
    "tax": {
      "rate": "<string>"
    },
    "unit": [
      {}
    ],
    "unit_en": "<string>",
    "units_per_package": "<string>",
    "unlimited_balance": "<string>",
    "updated_at": "2023-11-07T05:31:56Z",
    "updated_by": {
      "name": "<string>",
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "uuid": "<string>",
    "volume": "<string>"
  }
}

Authorizations

Authorizationstringheaderrequired

API key (Bearer token) created in Setup → API & MCP.

Path Parameters

uuidstringrequired

Record identifier (uuid)

Optional response field paths (dot notation for nested groups, e.g. billing_address.street; array fields are returned whole). Comma-separated string is also accepted. Identifier field is always included.

Response

Single record

recordobject

Fields enabled for this documentation instance (projection enabled: feature, option, subdomain, closures) plus account-level form field visibility. Role- and user-level field overrides are not applied here, so an API key whose staff user has such overrides may receive fewer fields. A disabled field is omitted from the response object entirely; a present key with a null value means the record simply has no value.

Show child attributes

Still need help? Ask the team

Authorizations

Path Parameters

Query Parameters

Response