# Jay Product Data API


The Jay Product Data API of the Media Jay application provides the capability to add full or update volatile (stock count, prices, etc.) product data.

#### Authentication

To access the endpoints you require a **X-API-Key** in the header.
Partners, please contact Transfermedia <support@transfermedia.de> to retrieve one.

#### Versioning
To use a specific implementation version of this API place it to the request header **X-API-Version**.
If the header is missed the latest implementation version **2025-07-09** is used.
The response header **X-API-Version** returns the implementation version the request was processed with.

#### Further documentation
For further details please visit the [documentation](https://docs.jay-metadata.com/) or contact Transfermedia <support@transfermedia.de>. 


Version: 2025-07-09

## Servers

Staging server
```
https://stage.shop.api.jay-metadata.com/v1
```

## Download OpenAPI description

[Jay Product Data API](https://docs.jay-metadata.com/_spec/apis/product/@latest/openapi.yaml)

## General configuration

### Get the general configuration of a retailer/e-commerce platform (merchant).

 - [GET /shops/config](https://docs.jay-metadata.com/apis/product/latest/openapi/general-configuration/getmerchantconfiguration.md): Get the general configuration of a retailer/e-commerce platform (merchant).

### Update the general configuration of a retailer/e-commerce platform (merchant).

 - [PATCH /shops/config](https://docs.jay-metadata.com/apis/product/latest/openapi/general-configuration/updatemerchantconfiguration.md): Update the general configuration of a retailer/e-commerce platform (merchant). Each field can be updated individually.

## Products

### Get the stock keeping units (article numbers) relevant to jay.

 - [GET /shops/products](https://docs.jay-metadata.com/apis/product/latest/openapi/products/queryproductstomonitor.md): Retrieves the stock keeping units (article numbers) relevant to jay. The response is paginated and returns a list for each language/country combination.

### Add a product description.

 - [POST /shops/products](https://docs.jay-metadata.com/apis/product/latest/openapi/products/addproductdescription.md): Add the full description for a product including all variants (e.g. sizes) associated to it.

### Update the volatile information for multiple products.

 - [PATCH /shops/products](https://docs.jay-metadata.com/apis/product/latest/openapi/products/updateproductstocks.md): Update the volatile information (stock count, price, etc.) for multiple main products and product variants in one step. The products are identified by their stock keeping unit (article number), language and country.

## API information

### Api Version

 - [GET /version](https://docs.jay-metadata.com/apis/product/latest/openapi/api-information/api_version_version_get.md)