> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.pricer24.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Getting product prices

# Introduction

If you want to load information about product prices into your system, the most convenient way is to use the **products** GET method.

* This method supports pagination.
* It returns only active products by default.
* Example request: **GET** `https://api.pricer24.com/v1/products?Include=...&MaxResultCount={PageSize}&SkipCount={PageSize}*{Page-1}&ApiKey={key}`

# Parameters

* Information about all available query parameters is available in [Swagger](https://api.pricer24.com/swagger/index.html)
* Available Include parameters: Availability, Category, Prices, ContractorsPrices, Tags

# Response Description

Array items contain information about your products:
* **id** – Pricer24 product code
* **externalId** – product code in your system (you can synchronize data with your accounting system using this field)
* **name** – product name
* **vendor** – product manufacturer
* **vendorCode** – product article number
* **link** – link to the product
* **barcode** – product barcode
* **stateId** – product status code (1 – active, 2 – archived)
* **availability** – an object with information about product availability (to get it, you need to request it in Include)
* **category** – an object with information about the product category (to get it, you need to request it in Include)
* **prices** – an array with your prices (to get it, you need to request it in Include)
* **contractorsPrices** – an array with contractor prices (to get it, you need to request it in Include)
* **tags** – an array with product tags (to get it, you need to request it in Include)

### Prices Array
The prices array contains objects with information about your prices for product:
![](https://storage.crisp.chat/users/helpdesk/website/c264ea040288d800/image_qw7g5t.png)


* **price** – price
* **currencyId** – currency of the price
* **priceType** – information about your price (one product can have several prices; for example: regular price, promotional price, recommended retail price, etc.)

 **priceType** object:
* **id** – Pricer24 product price type code
* **name** – price name

### ContractorsPrices Array

|| Explanation: The term “contractor” in the Pricer24 system refers to any site that the client wants to monitor. Pricer24 clients are vendors, distributors, and online stores. For vendors and distributors, “contractor” means the online store of a retail partner. For online stores, “contractor” means a competitor’s online store.

||| Prices are returned only for active products.

The **contractorsPrices** array contains objects with information about contractor prices for your product:
![](https://storage.crisp.chat/users/helpdesk/website/c264ea040288d800/image_1yr6hc9.png)

* **name** – contractor product name (what the product is called on the website or in the price list of another seller)
* **isAvail** – flag indicating whether the product is in stock or out of stock
* **url** – link to the product
* **parsedOn** – date and time in UTC when the product information was collected
* **contractor** – an object with information about the contractor
* **prices** – an array with product prices
* **avails** – an array with product availability

###### Contractor Object
![](https://storage.crisp.chat/users/helpdesk/website/c264ea040288d800/image_1m1rv6n.png)
* **name** – contractor name
* **externalId** – product code in your system (you can synchronize data with your accounting system using this field)
* **id** – Pricer24 contractor code

###### Prices Array Object
![](https://storage.crisp.chat/users/helpdesk/website/c264ea040288d800/image_a7w5bq.png)
* **price** – price
* **currency** – currency of the price
* **ext** – object with extended price information
* **priceType** – information about the contractor’s price

priceType object:
* **code** – a unique identifier of a price type on another seller's website or in a price list
* **name** – a name that corresponds to a price type on another seller's website or in a price list (regular, RRP, promo, etc)
* **priceSetId** – Pricer24 Price Group code
* **id** – Pricer24 contractor price code

###### Avails Array Object
![](https://storage.crisp.chat/users/helpdesk/website/c264ea040288d800/image_cvokzg.png)

* **avail** – the status of stock availability as indicated by text on the contractor's website (e.g., 'In Stock,' 'Out of Stock')"
* **isAvail** – flag indicating whether the product is in stock at a given warehouse
* **warehouse** – information about the contractor’s warehouse

Warehouse object:
* **code** – contractor warehouse code
* **name** – contractor warehouse name
* **id** – Pricer24 contractor warehouse code

# Example Request

Example request to get the first 100 products with my prices and contractor prices:
**GET** `https://api.pricer24.com/v1/products?Include=Prices,ContractosPrices&MaxResultCount=100&SkipCount=0&ApiKey={key}`