# Retrieve a product

> Retrieve a product by its identifier.
{/* generated:versioned-pages - edit _pm-authored, not this file */}

`GET /api/products/{id}`

Retrieves a Product resource.

Returns a single product by id. Pass `expand=variants` to embed variants, and `resolveContext[*]` to populate `resolvedPrice` on each embedded variant for the chosen channel, country and timestamp.

## Headers

| Name              | Type     | Required | Description                                                                                                      |
| ----------------- | -------- | -------- | ---------------------------------------------------------------------------------------------------------------- |
| `Flowkiwi-Locale` | `string` | -        | Specifies the locale for properties that support localization. If not provided, the default locale will be used. |

## Path parameters

| Name | Type     | Required | Description        |
| ---- | -------- | -------- | ------------------ |
| `id` | `string` | Yes      | Product identifier |

## Query parameters

| Name                      | Type     | Required | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------------------- | -------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `resolveContext[channel]` | `string` | -        | Channel IRI used to resolve the variant price. Required together with `resolveContext[country]`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `resolveContext[country]` | `string` | -        | Country IRI used to resolve the variant price. Required together with `resolveContext[channel]`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `resolveContext[at]`      | `string` | -        | ISO 8601 UTC timestamp at which the price is resolved. Defaults to the current time when omitted.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `expand`                  | `string` | -        | Comma-separated list of relations to embed as full objects instead of IRI strings. Supported values: `variants`, `options`, `optionValues`, `medias`, `category`, `collections`, `channels`, `metafields`, `metaobject`. Tokens are independent; unknown values are silently ignored. `optionValues` only has a visible effect when combined with `variants`. `medias` and `metafields` apply to the product and, when combined with `variants`, to each variant. `metaobject` only has a visible effect when combined with `metafields` (it embeds the referenced metaobject on each metafield of type `metaobject_reference` or `list__metaobject_reference`). |

## Response

**200** - Product resource

| Property          | Type             | Required | Description                                                                                                                                                                                                                                                                                                   |
| ----------------- | ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `@context`        | `object`         | -        |                                                                                                                                                                                                                                                                                                               |
| `@id`             | `string`         | Yes      |                                                                                                                                                                                                                                                                                                               |
| `@type`           | `string`         | Yes      |                                                                                                                                                                                                                                                                                                               |
| `id`              | `string`         | -        | Stable UUID of the product.                                                                                                                                                                                                                                                                                   |
| `status`          | `string`         | -        | The status of the product.                                                                                                                                                                                                                                                                                    |
| `vendor`          | `string \| null` | -        | The name of the product's vendor.                                                                                                                                                                                                                                                                             |
| `title`           | `string \| null` | -        | **This property supports translations.**<br><br>The name of the product.                                                                                                                                                                                                                                      |
| `description`     | `string \| null` | -        | **This property supports translations.**<br><br>A description of the product.                                                                                                                                                                                                                                 |
| `tags`            | `string \| null` | -        | A string of comma-separated tags.                                                                                                                                                                                                                                                                             |
| `variants`        | `string[]`       | -        | A list of `Variant`, each one representing a variant associated with the product. Serialized as IRI strings by default; pass `?expand=variants` to embed the full `Variant` objects (including `resolvedPrice`, `lowestPriceLast30Days`, `medias`, and `metafields` when composed with `?expand=metafields`). |
| `options`         | `string[]`       | -        | A list of `Product Option`, each one representing an option associated with the product. Serialized as IRI strings by default; pass `?expand=options` to embed the full `Product Option` objects.                                                                                                             |
| `category`        | `string \| null` | -        | The category to which this product belongs. Serialized as IRI string by default; pass `?expand=category` to embed the full `CategoryResource`.                                                                                                                                                                |
| `attributeValues` | `array`          | -        | A list of `Attribute Values`, each one representing an attribute value associated with the product.                                                                                                                                                                                                           |
| `channels`        | `string[]`       | -        | A list of `Channel`, each one representing a channel associated with the product. Serialized as IRI strings by default; pass `?expand=channels` to embed full `ChannelResource` objects.                                                                                                                      |
| `collections`     | `string[]`       | -        | A list of `Collection`, each one representing a collection associated with the product. Serialized as IRI strings by default; pass `?expand=collections` to embed full `CollectionResource` objects.                                                                                                          |
| `medias`          | `string[]`       | -        | A list of `Media`, ordered by position. Only media of type "image" can be associated with a product. Returned as IRI strings by default; pass `?expand=medias` to embed full `Media` objects.                                                                                                                 |
| `metafields`      | `string[]`       | -        | Metafields owned by this product. Serialized as IRI strings by default; pass `?expand=metafields` to embed full `MetafieldResource` objects.                                                                                                                                                                  |
| `createdAt`       | `string`         | -        | The date and time when the resource was created (ISO 8601 format).                                                                                                                                                                                                                                            |
| `updatedAt`       | `string`         | -        | The date and time when the resource was last modified (ISO 8601 format).                                                                                                                                                                                                                                      |

## Errors

**403** - Access denied. The caller is missing one or more identity permissions required for this operation.

| Property             | Type       | Required | Description                                                                                                                                |
| -------------------- | ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `@context`           | `object`   | -        |                                                                                                                                            |
| `@id`                | `string`   | Yes      |                                                                                                                                            |
| `@type`              | `string`   | Yes      |                                                                                                                                            |
| `type`               | `string`   | -        |                                                                                                                                            |
| `title`              | `string`   | -        |                                                                                                                                            |
| `status`             | `integer`  | -        |                                                                                                                                            |
| `detail`             | `string`   | -        |                                                                                                                                            |
| `missingPermissions` | `string[]` | -        | Identity permissions that the caller is missing for this operation. Present only when the 403 is caused by a denied identity:* permission. |

**404** - Not found

| Property      | Type              | Required | Description                                                                                                                          |
| ------------- | ----------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `@context`    | `object`          | -        |                                                                                                                                      |
| `@id`         | `string`          | Yes      |                                                                                                                                      |
| `@type`       | `string`          | Yes      |                                                                                                                                      |
| `title`       | `string \| null`  | -        | A short, human-readable summary of the problem.                                                                                      |
| `detail`      | `string \| null`  | -        | A human-readable explanation specific to this occurrence of the problem.                                                             |
| `status`      | `integer \| null` | -        |                                                                                                                                      |
| `instance`    | `string \| null`  | -        | A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. |
| `type`        | `string`          | -        | A URI reference that identifies the problem type                                                                                     |
| `description` | `string \| null`  | -        |                                                                                                                                      |

## Examples

### Example request

```bash
curl -X GET 'https://<tenant>.product-management.flowkiwi.net/api/products/<product_id>' \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Flowkiwi-Api-Version: 2026-07' \
  -H 'Accept: application/ld+json'
```

### Example response

```json
{
  "@context": "/api/contexts/Product",
  "@id": "/api/Products/53536f7d-dd25-5238-b789-e234a4420fd0",
  "@type": "Product",
  "id": "53536f7d-dd25-5238-b789-e234a4420fd0",
  "status": "/api/statuses/DRAFT",
  "vendor": "EcoWear",
  "title": "Premium Organic Cotton T-Shirt",
  "description": "Comfortable and sustainable t-shirt made from 100% organic cotton. Available in multiple colors.",
  "tags": "organic,sustainable,cotton,apparel",
  "variants": [],
  "options": [],
  "images": [],
  "category": null,
  "attributeValues": [],
  "channels": [],
  "collections": [],
  "createdAt": "2024-01-01T00:00:00+00:00",
  "updatedAt": "2024-01-01T00:00:00+00:00"
}
```