# Retrieve a variant > Retrieve a single variant by its identifier. {/* generated:versioned-pages - edit _pm-authored, not this file */} `GET /api/products/{productId}/variants/{variantId}` Retrieves a Product Variant resource. Returns a single variant of a product by id. Pass `resolveContext[*]` to populate `resolvedPrice` for the chosen channel, country and timestamp. ## Path parameters | Name | Type | Required | Description | | ----------- | -------- | -------- | -------------------------- | | `productId` | `string` | Yes | ProductResource identifier | | `variantId` | `string` | Yes | Product Variant 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: `optionValues`, `medias`, `metafields`, `metaobject`, `product`. Tokens are independent; unknown values are silently ignored. `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`). | | `properties[]` | `string[]` | - | Allows you to reduce the response to contain only the properties you need. If your desired property is nested, you can address it using nested arrays. Example: properties[]={propertyName}&properties[]={anotherPropertyName}&properties[{nestedPropertyParent}][]={nestedProperty} | ## Response **200** - Product Variant resource | Property | Type | Required | Description | | --------------- | ------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `@context` | `string \| object` | - | | | `@id` | `string` | Yes | | | `@type` | `string` | Yes | | | `barcode` | `string` | Yes | The barcode, unique UPC, or ISBN number for the product. | | `createdAt` | `string` | - | The date and time when the resource was created (ISO 8601 format). | | `id` | `string` | - | The resource's unique identifier (UUID). | | `measurement` | `EmbeddedMeasurementResource \| null` | - | The measurement used to compute per-unit prices for the variant. | | `medias` | `array` | - | A list of `Media`, ordered by position. Only media of type "image" can be associated with a variant. Returned as IRI strings by default; pass `?expand=medias` to embed full `Media` objects. Requires the `medias:read` scope. Returned empty when the scope is missing. | | `metafields` | `array` | - | Metafields owned by this variant. Serialized as IRI strings by default; pass `?expand=metafields` to embed full `MetafieldResource` objects. Requires the `metafields:read` scope. Returned empty when the scope is missing. | | `optionValues` | `array` | - | A list of `Option Value`, each one representing an option value associated with the variant. Requires the `products:read` scope. Returned empty when the scope is missing. | | `product` | `string \| Product \| null` | Yes | The product resource it belongs to. Requires the `products:read` scope. Returned null when the scope is missing. | | `resolvedPrice` | `ResolvedPriceResource \| null` | - | The price resolved for the current `resolveContext` (country, channel and instant). Null unless `resolveContext[country]`, `resolveContext[channel]` and `resolveContext[at]` are all provided. | | `sku` | `string` | Yes | A unique identifier for the product variant. | | `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 permissions required for this operation. | Property | Type | Required | Description | | -------------------- | ------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------- | | `@context` | `string \| object` | - | | | `@id` | `string` | Yes | | | `@type` | `string` | Yes | | | `detail` | `string` | - | | | `missingPermissions` | `string[]` | - | Permissions that the caller is missing for this operation. Present only when the 403 is caused by a denied permission. | | `status` | `integer` | - | | | `title` | `string` | - | | | `type` | `string` | - | | **404** - Not found | Property | Type | Required | Description | | ------------- | ------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------ | | `@context` | `string \| object` | - | | | `@id` | `string` | Yes | | | `@type` | `string` | Yes | | | `code` | `string` | - | Stable identifier of the error in the error code catalogue (see /api/error-codes). Present on catalogued errors only. | | `description` | `string \| null` | - | | | `detail` | `string \| null` | - | A human-readable explanation specific to this occurrence of the problem. | | `instance` | `string \| null` | - | A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. | | `message` | `string` | - | End-user message localized in the request locale, with this occurrence's values substituted. Present on catalogued errors only. | | `slug` | `string` | - | Stable, readable key of the error in the error code catalogue. Present on catalogued errors only. | | `status` | `integer \| null` | - | | | `title` | `string \| null` | - | A short, human-readable summary of the problem. For a catalogued error it repeats the `slug`. | | `type` | `string` | - | A URI reference that identifies the problem type. For a catalogued error it is the error code resource, `/api/error-codes/{code}`. | ## Examples ### Example request ```bash curl -X GET 'https://.product-management.flowkiwi.net/api/products//variants/' \ -H 'Authorization: Bearer {access_token}' \ -H 'Flowkiwi-Api-Version: unstable' \ -H 'Accept: application/ld+json' ``` ### Example response ```json { "@context": "/api/contexts/Product%20Variant", "@id": "/api/products/019af93e-420e-79f8-800b-6680f03dce20/variants/67ac49d4-c3d3-560d-ad66-fb3321801edf", "@type": "Product Variant", "barcode": "BAR-001-A", "createdAt": "2024-01-01T00:00:00+00:00", "id": "67ac49d4-c3d3-560d-ad66-fb3321801edf", "measurement": { "measuredType": "volume", "quantityUnit": "cl", "quantityValue": 70, "referenceUnit": "l", "referenceValue": 1 }, "medias": [], "optionValues": [ "/api/product_options/019af941-6b7c-7d8e-9f0a-2b3c4d5e6f70/option_values/48e92020-a038-589d-977b-4ad9bdf9e8ec", "/api/product_options/019af941-6b7c-7d8e-9f0a-2b3c4d5e6f70/option_values/2558340c-6c44-50c2-a47d-ea9b96d273a0" ], "product": "/api/products/019af93e-420e-79f8-800b-6680f03dce20", "sku": "SKU-ABC-001", "updatedAt": "2024-01-01T00:00:00+00:00" } ```