# Get a catalog item by ID

**GET /api/catalog/{id}**

Retrieves the details of a specific catalog item using its unique ID.


## Servers
- Local development server: http://localhost:8000 (Local development server)



## Parameters

### Path parameters
- **id** (integer(int64))
  The unique integer ID of the catalog item.



## Responses
### 200
Successfully retrieved catalog item details. The `item_vector` field will be present and contain the 32-element array if stored, or it will be `null` (or potentially omitted depending on server encoding settings if `omitempty` is used) if not stored.

#### Body: application/json (object)
- **id** (integer(int64))
  Unique identifier for the catalog item (generated by the server).
- **category** (string)
  The category of the item. Determines the structure of 'attributes'.
- **item_name** (string)
  The name of the catalog item.
- **brand_id** (string)
  Identifier for the item's brand.
- **item_url** (string(url))
  URL link to the item's product page.
- **price** (number(double))
  Price of the item.
- **item_img** (string(url))
  URL link to an image of the item.
- **attributes** (object)
  Key-value pairs describing item-specific attributes. **Required keys depend on the `category` field.**

  **Category `tops`:**
  ```json
  {
    "size": "string",
    "fit": "string",
    "materials": ["string"],
    "pattern": "string",
    "colors": ["string"],
    "neckline": "string",
    "sleeve_length": "string",
    "closure_type": "string"
  }
  ```
  **Category `dresses`:**
  ```json
  {
    "size": "string",
    "fit": "string",
    "materials": ["string"],
    "pattern": "string",
    "colors": ["string"],
    "sleeve_length": "string",
    "shoulder_exposure": "string",
    "closure_type": "string",
    "back_exposure": "string",
    "neck_line": "string",
    "skirt_length": "string",
    "leg_cut": "string",
    "gender": "string",
    "seasonality": "string"
  }
  ```
  **Category `pants`:**
  ```json
  {
    "fit": "string",
    "materials": ["string"],
    "pattern": "string",
    "colors": ["string"],
    "length_to_knee": "string",
    "inseam": 0.0,
    "gender": "string",
    "seasonality": "string"
  }
  ```
  **Category `outerwear`:**
  ```json
  {
    "materials": ["string"],
    "pattern": "string",
    "colors": ["string"],
    "sleeve_length": "string",
    "gender": "string",
    "seasonality": "string"
  }
  ```
  **Category `shoes`:**
  ```json
  {
    "size": 0.0,
    "wide": "string",
    "colors": ["string"],
    "pattern": "string",
    "materials": ["string"],
    "shoe_height": "string",
    "heels": "string",
    "boots": "string",
    "gender": "string",
    "seasonality": "string"
  }
  ```
  **Category `accessories`:**
  ```json
  {
    "colors": ["string"],
    "worn": "string",
    "materials": ["string"],
    "closure_type": "string",
    "gender": "string",
    "seasonality": "string"
  }
  ```
- **item_vector** (array[number(float)] | null)
  Optional 32-dimensional vector embedding for the item. Will be `null` if not provided or stored.

### 400
Bad Request (Invalid ID format).

#### Body: application/json (object)
- **error** (string)
  A message describing the error.

### 404
Not Found (Item with the specified ID does not exist).

#### Body: application/json (object)
- **error** (string)
  A message describing the error.

### 500
Internal Server Error

#### Body: application/json (object)
- **error** (string)
  A message describing the error.


[Powered by Bump.sh](https://bump.sh)