Retrieve an option value
get
/api/product_options/{productOptionId}/option_values/{optionValueId} Retrieves a Option Value resource.
Returns a single value of an option by id. Set the Flowkiwi-Locale header to read the translatable value in a given locale.
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 |
|---|---|---|---|
productOptionId | string | required | ProductOptionResource identifier |
optionValueId | string | required | Option Value identifier |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
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 - Option Value resource
| Property | Type | Required | Description |
|---|---|---|---|
@context | string | object | - | |
@id | string | required | |
@type | string | required | |
createdAt | string | - | The date and time when the resource was created (ISO 8601 format). |
id | string | - | |
position | integer | null | - | The position of the option value. Use -1 to put the option value at the end. |
productOption | string | null | required | The Product Option to which this option value belongs. Requires the products:read scope. Returned null when the scope is missing. |
updatedAt | string | - | The date and time when the resource was last modified (ISO 8601 format). |
value | string | null | required | This property supports translations. The value of the option. |
variants | string[] | - | A list of Variant, each one representing a variant associated with the option value. Requires the products:read scope. Returned empty when the scope is missing. |
| Property | Type | Required | Description |
|---|---|---|---|
createdAt | string | - | The date and time when the resource was created (ISO 8601 format). |
id | string | - | |
position | integer | null | - | The position of the option value. Use -1 to put the option value at the end. |
productOption | string | null | required | The Product Option to which this option value belongs. Requires the products:read scope. Returned null when the scope is missing. |
updatedAt | string | - | The date and time when the resource was last modified (ISO 8601 format). |
value | string | null | required | This property supports translations. The value of the option. |
variants | string[] | - | A list of Variant, each one representing a variant associated with the option value. Requires the products:read scope. Returned empty when the scope is missing. |
Errors
403 - Access denied. The caller is missing one or more permissions required for this operation.
Content-Type: application/problem+json
| Property | Type | Required | Description |
|---|---|---|---|
@context | string | object | - | |
@id | string | required | |
@type | string | required | |
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 | required | |
@type | string | required | |
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}. |
| Property | Type | Required | Description |
|---|---|---|---|
code | string | - | Stable identifier of the error in the error code catalogue (see /api/error-codes). Present on catalogued errors only. |
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}. |