# Get Product

Returns a single Product resource by its identifier.
## Authentication
Requires a valid API key in the `X-API-KEY` header.
## Headers
### Accept-Language
Indicates the preferred natural language and locale for localized content.
- **omitted / null**
: content in the tenant's default culture.
- **culture-code**
 (e.g.
`en-US`
,
`es`
): content localized in the specified culture.
- **`*`**
 and q-factor weighting are currently not supported.

## OData Query Support
### $select
Comma-separated list of root-resource property names to include in the response.
See `/Products/$metadata` for the available properties.
Selecting properties of embedded resources is not supported.
Example: `$select=prod_description,prod_tags`
### $expand
Comma-separated list of related collections to **count**. `$expand` does not embed the related
resources: each returned Product gets one extra property per expanded collection, holding the
number of related items. Nothing is added by default.
- `Variants`
 — the product's variants (deleted variants are not counted) → property
`Variants@count`
.
- `Categories`
 — the categories the product belongs to → property
`Categories@count`
.

Any other value is rejected with `400 Bad Request`. To read the variants themselves, use
`GET /Products({productIdentifier})/Variants`; to read the product's categories, select
`cat_id` or `cat_ref`.
Example: `$expand=Variants` → `{ "prod_id": 1, "prod_ref": "SKU-001", "Variants@count": 2 }`
## Response
**200 OK** — `EntityRepresentation` with the Product resource.
## Error Responses
- **400 Bad Request**
 — Invalid OData expression (returns
`ValidationFailureRepresentation`
).
- **401 Unauthorized**
 — Missing or invalid API key. Returned by the API gateway as

`{ "message": "Unauthorized", "request_id": "d8aafa5b8f3e400b60bea0123dd33317" }`
.
- **404 Not Found**
 — Product with the given identifier does not exist.
- **500 Internal Server Error**
 — Unexpected technical error.

## Example
**Request:**

```http
GET /Products(456)?$select=prod_description,prod_tags&$expand=Variants HTTP/1.1
X-API-KEY: your-api-key-here
Accept-Language: en-US
```
**Response:**

```http
HTTP/1.1 200 OK
Content-Type: application/json
```

Endpoint: GET /Products({productIdentifier})
Version: 2.0.0

## Description:

  - `Authentication` ()
    Requires a valid API key in the `X-API-KEY` header.

  - `Headers` ()

  - `Accept-Language` ()
    Indicates the preferred natural language and locale for localized content. - **omitted / null**
: content in the tenant's default culture.
- **culture-code**
 (e.g.
`en-US`
,
`es`
): content localized in the specified culture.
- **`*`**
 and q-factor weighting are currently not supported.

  - `OData Query Support` ()

  - `$select` ()
    Comma-separated list of root-resource property names to include in the response.
See `/Products/$metadata` for the available properties.
Selecting properties of embedded resources is not supported. Example: `$select=prod_description,prod_tags`

  - `$expand` ()
    Comma-separated list of related collections to **count**. `$expand` does not embed the related
resources: each returned Product gets one extra property per expanded collection, holding the
number of related items. Nothing is added by default. - `Variants`
 — the product's variants (deleted variants are not counted) → property
`Variants@count`
.
- `Categories`
 — the categories the product belongs to → property
`Categories@count`
. Any other value is rejected with `400 Bad Request`. To read the variants themselves, use
`GET /Products({productIdentifier})/Variants`; to read the product's categories, select
`cat_id` or `cat_ref`. Example: `$expand=Variants` → `{ "prod_id": 1, "prod_ref": "SKU-001", "Variants@count": 2 }`

  - `Response` ()
    **200 OK** — `EntityRepresentation` with the Product resource.

  - `Error Responses` ()
    - **400 Bad Request**
 — Invalid OData expression (returns
`ValidationFailureRepresentation`
).
- **401 Unauthorized**
 — Missing or invalid API key. Returned by the API gateway as

`{ "message": "Unauthorized", "request_id": "d8aafa5b8f3e400b60bea0123dd33317" }`
.
- **404 Not Found**
 — Product with the given identifier does not exist.
- **500 Internal Server Error**
 — Unexpected technical error.

  - `Example` ()
    **Request:** ```http
GET /Products(456)?$select=prod_description,prod_tags&$expand=Variants HTTP/1.1
X-API-KEY: your-api-key-here
Accept-Language: en-US
``` **Response:** ```http
HTTP/1.1 200 OK
Content-Type: application/json
```

## Path parameters:

  - `productIdentifier` (integer, required)
    Product resource identifier

## Query parameters:

  - `$select` (string)

  - `$expand` (string)

## Header parameters:

  - `X-API-KEY` (string)
    Tenant's API key (required)

  - `Accept-Language` (string)
    Preferred localization culture (Accept-Language header)

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `@readLink` (string)

  - `@editLink` (string)

  - `@etag` (string)

  - `@navigationLinks` (array)

  - `@navigationLinks.uri` (string)

  - `@associationLinks` (array)

  - `@associationLinks.uri` (string)

  - `@context` (string)

  - `value` (any)

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 400 fields (application/json):

  - `validationFailures` (object)

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `message` (string)

  - `request_id` (string)

## Response 404:

  - `404` (unknown)
    Not Found

## Response 404 fields (application/json):

  - `type` (string)

  - `title` (string)

  - `status` (integer)

  - `detail` (string)

  - `instance` (string)

## Response 500:

  - `500` (unknown)
    Internal Server Error

## Response 500 fields (application/json):

  - `error` (string)

  - `details` (any)

