---
updatedAt: 2026-06-09T11:44:04.000Z
agentTools:
  projectIndex: https://docs.tweakwise.com/llms.txt
---

# Get item

Returns a single item with the specified article number.

<Callout icon="💡" theme="default">
  ### Read more about [Items & item types](https://docs.tweakwise.com/docs/items-item-types)
</Callout>

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "v1",
    "title": "Tweakwise Backend API"
  },
  "paths": {
    "/item/{articleNumber}": {
      "get": {
        "tags": [
          "Item"
        ],
        "summary": "Get item",
        "description": "Returns a single item with the specified article number.",
        "operationId": "Item_GetItem",
        "parameters": [
          {
            "name": "articleNumber",
            "in": "path",
            "description": "Article number for the item to retrieve.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ItemApiModel"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ItemApiModel"
                }
              }
            }
          },
          "404": {
            "description": "Item not found"
          }
        },
        "security": [
          {
            "apiKeyDefinition": [],
            "instanceKeyDefinition": []
          }
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://navigator-api.tweakwise.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "apiKeyDefinition": {
        "type": "apiKey",
        "description": "API Key Authentication",
        "name": "TWN-Authentication",
        "in": "header"
      },
      "instanceKeyDefinition": {
        "type": "apiKey",
        "description": "Instance key",
        "name": "TWN-InstanceKey",
        "in": "header"
      }
    },
    "schemas": {
      "ItemApiModel": {
        "description": "An item. Can be a product or a content item",
        "type": "object",
        "properties": {
          "ArticleNumber": {
            "description": "The article number. Uniquely identifies an item",
            "type": "string"
          },
          "Name": {
            "description": "Item name",
            "type": "string"
          },
          "Price": {
            "format": "double",
            "description": "Item price",
            "type": "number"
          },
          "Brand": {
            "description": "Item brand",
            "type": "string"
          },
          "Stock": {
            "format": "int32",
            "description": "Item stock",
            "type": "integer"
          },
          "GroupCode": {
            "description": "Item group code, used in grouped navigation and search",
            "type": "string"
          },
          "Image": {
            "description": "Item image url",
            "type": "string"
          },
          "Url": {
            "description": "Item url",
            "type": "string"
          },
          "LastModified": {
            "format": "date-time",
            "description": "The last modified date of the item",
            "type": "string"
          },
          "UpdatedBy": {
            "description": "The source that updated the item",
            "enum": [
              "Feed",
              "Api",
              "App"
            ],
            "type": "string"
          },
          "Categories": {
            "description": "List of categories this item falls in",
            "type": "array",
            "items": {
              "format": "int64",
              "type": "integer"
            }
          },
          "Attributes": {
            "description": "List of item attributes",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ItemAttributeApiModel"
            }
          },
          "Status": {
            "description": "Item status (Active/Inactive)",
            "enum": [
              "Active",
              "Inactive"
            ],
            "type": "string"
          }
        }
      },
      "ItemAttributeApiModel": {
        "description": "Item attribute",
        "type": "object",
        "properties": {
          "Id": {
            "format": "int64",
            "description": "Attribute id",
            "type": "integer"
          },
          "Key": {
            "description": "Attribute key",
            "type": "string"
          },
          "Values": {
            "description": "List of attribute values",
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```