---
title: "Product API"
canonical: "https://knowledge-hub.onetrail.com/space/docs/718702393/Product%20API"
format: markdown
---
### Product Now

The Onetrail Product Now service allows for much faster and more efficient connection to the Onetrail services. It has been developed in order to reduce our footprint and maximize efficiency. Here are the ins and outs of this Product Now version.

### **Benefits**

**These are advantages of using the Product Now:**

- RESTful services have a smaller footprint than SOAP, Parsing JSON is less computationally heavy and memory intensive then XML, however we can still support XML as well.
- Improved efficiency allows us to support bulk requests as well as single requests, this will allow buyers to retrieve multiple items with 1 request rather than multiple single requests.
- The health check will allow you to monitor the availability and uptime of the service.
- On daily bases you can retrieve a list of changed products and via the bulk request, retrieve the updated products.
- The API supports basic authentication only, for this you need a service user created in TPN Manager.


**Base_url:**

  - ACC: [https://acc-rest.onetrail.net/](https://acc-rest.onetrail.net/)
  - PRD: [https://rest.onetrail.net/](https://rest.onetrail.net/)

### **Syntax**

# ProductAPI - v1

API for retrieving product data.

## Endpoint: productApi/v1/products

### Method: GET

**Summary: **Provides product data to buyers. The buyer GLN is determined based on the username

**Operation ID: **route7

#### Parameters:

- **PDINumber **(query): PDI number
- **SellerVPN **(query): Manufacturer Part Number
- **GTIN **(query): GTIN
- **Quantity **(query): Quantity for which you want the price and availability
- **BidID **(query): Contract ID for the price of a contract product
- **SellerGLN **(query): Seller GLN
- **RealTime **(query): Real time

#### Responses:

- **200 **:

## Endpoint: productApi/v1/products/bulk

### Method: POST

**Summary: **Get multiple products (note: bulk requests return data from the Onetrail database and not realtime responses from a supplier endpoint)

**Operation ID: **route9

#### Parameters:

- **body **(body): List of requested items

#### Responses:

- **200 **: success
- **204 **: no items were found
- **207 **: success
- **400 **: bad request
- **401 **: user not authorized
- **500 **: internal server error
- **501 **: not supported yet

## Endpoint: productApi/v1/products/index

### Method: GET

**Summary: **Get product index

**Operation ID: **route11

#### Parameters:

- **onlyModified **(query): Return only modified products, Currently only value 'true' is supported.
- **onlySubscribed **(query): Return only subscribed products.
- **SellerGLN **(query): Return only products from a particular seller.

#### Responses:

- **200 **: success
- **204 **: no items were found
- **400 **: bad request
- **401 **: user not authorized
- **500 **: internal server error
- **501 **: not supported yet

## Endpoint: productApi/v1/products/buyer/{BuyerGLN}/seller/{SellerGLN}/pdi/{PDINumber}

### Method: GET

**Summary: **An internal endpoint used for fetching product data by the Product Guide

**Operation ID: **route13

#### Parameters:

- **BuyerGLN **(path): Buyer GLN
- **SellerGLN **(path): Seller GLN
- **PDINumber **(path): PDI number

#### Responses:

- **200 **:

## Endpoint: productApi/v1/healthCheck

### Method: GET

**Summary: **Get limited customer health check

**Operation ID: **route17

#### Responses:

- **200 **:

## Endpoint: productApi/v1/ping

### Method: GET

**Summary: **Ping endpoint

**Operation ID: **route18

#### Responses:

- **200 **:

### Downloads

> ✅ **Download**
> ✅ 
> ✅ OpenAPI definition for Product Now: