Tradeprint API Sandbox

https://www.postman.com/tradeprint/tradeprint-api-s-public-workspace/collection/wal5636/tradeprint-api-sandbox
Admin
A sandbox environment for the Tradeprint API, allowing customers to interact with API endpoints in...
Tokens:1,785
Snippets:8
Trust Score:10
Update:10 months ago
Show doc for...
Tokens:
Raw
### GET /products/v2 - Get All Products Attributes

Source: https://www.postman.com/tradeprint/tradeprint-api-s-public-workspace/collection/wal5636/tradeprint-api-sandbox/index

Retrieve all available product attributes. This endpoint provides comprehensive details about each product in the catalog.

```APIDOC
## GET /products/v2 - Get All Products Attributes

### Description
Retrieves a comprehensive list of all available product attributes.

### Method
GET

### Endpoint
/products/v2

### Parameters
No parameters required for this request.

### Request Example
(No request body for GET requests)

### Response
#### Success Response (200)
- **products** (array) - A list of all products with their attributes.
  - **productId** (string) - The unique identifier for a product.
  - **name** (string) - The name of the product.
  - **description** (string) - A detailed description of the product.
  - **attributes** (object) - Key-value pairs of product attributes.
- **success** (boolean) - Indicates if the request was successful.

#### Response Example
```json
{
  "products": [
    {
      "productId": "prod_abc",
      "name": "Premium T-Shirt",
      "description": "High quality cotton t-shirt.",
      "attributes": {
        "color": "Blue",
        "size": "L",
        "material": "Cotton"
      }
    },
    {
      "productId": "prod_xyz",
      "name": "Standard Mug",
      "description": "Ceramic mug for everyday use.",
      "attributes": {
        "color": "White",
        "capacity": "11oz"
      }
    }
  ],
  "success": true
}
```
```

--------------------------------

### POST /products/v2 - Request Price List for Single Product

Source: https://www.postman.com/tradeprint/tradeprint-api-s-public-workspace/collection/wal5636/tradeprint-api-sandbox/index

This endpoint allows you to request the price list for a single product. Provide the product identifier to get its corresponding pricing information.

```APIDOC
## POST /products/v2 - Request Price List for Single Product

### Description
Requests the price list for a single product by providing its unique identifier.

### Method
POST

### Endpoint
/products/v2

### Parameters
#### Request Body
- **product** (object) - Required - Details of the product for which to request pricing.
  - **productId** (string) - Required - The unique identifier for the product.
  - **quantity** (integer) - Optional - The desired quantity for pricing calculation.

### Request Example
```json
{
  "product": {
    "productId": "single_product_id",
    "quantity": 5
  }
}
```

### Response
#### Success Response (200)
- **price** (number) - The calculated price for the product.
- **currency** (string) - The currency of the price.
- **success** (boolean) - Indicates if the request was successful.

#### Response Example
```json
{
  "price": 75.50,
  "currency": "GBP",
  "success": true
}
```
```

--------------------------------

### POST /products/v2 - Request Price Lists for Multiple Products

Source: https://www.postman.com/tradeprint/tradeprint-api-s-public-workspace/collection/wal5636/tradeprint-api-sandbox/index

This endpoint allows you to request price lists for multiple products simultaneously. Provide a list of product identifiers to get their corresponding pricing information.

```APIDOC
## POST /products/v2 - Request Price Lists for Multiple Products

### Description
Requests price lists for multiple products by providing a list of product identifiers.

### Method
POST

### Endpoint
/products/v2

### Parameters
#### Request Body
- **products** (array) - Required - A list of product identifiers for which to request price lists.
  - **productId** (string) - Required - The unique identifier for a product.
  - **quantity** (integer) - Optional - The desired quantity for pricing calculation.

### Request Example
```json
{
  "products": [
    {
      "productId": "example_product_1",
      "quantity": 10
    },
    {
      "productId": "example_product_2"
    }
  ]
}
```

### Response
#### Success Response (200)
- **prices** (array) - A list of pricing information for the requested products.
  - **productId** (string) - The identifier of the product.
  - **price** (number) - The calculated price for the product.
  - **currency** (string) - The currency of the price.
- **success** (boolean) - Indicates if the request was successful.

#### Response Example
```json
{
  "prices": [
    {
      "productId": "example_product_1",
      "price": 150.75,
      "currency": "GBP"
    },
    {
      "productId": "example_product_2",
      "price": 200.00,
      "currency": "GBP"
    }
  ],
  "success": true
}
```
```

--------------------------------

### POST /products/v2 - Get Expected Delivery Date

Source: https://www.postman.com/tradeprint/tradeprint-api-s-public-workspace/collection/wal5636/tradeprint-api-sandbox/index

Calculate the expected delivery date for a product based on specified details. This endpoint requires product information and potentially location data.

```APIDOC
## POST /products/v2 - Get Expected Delivery Date

### Description
Calculates the expected delivery date for a product based on provided details.

### Method
POST

### Endpoint
/products/v2

### Parameters
#### Request Body
- **productDetails** (object) - Required - Information about the product and order.
  - **productId** (string) - Required - The unique identifier for the product.
  - **quantity** (integer) - Required - The quantity of the product.
  - **deliveryAddress** (object) - Optional - The address for delivery.
    - **postcode** (string) - Required if deliveryAddress is provided - The postcode for delivery.
    - **country** (string) - Required if deliveryAddress is provided - The country for delivery.

### Request Example
```json
{
  "productDetails": {
    "productId": "product_to_deliver",
    "quantity": 20,
    "deliveryAddress": {
      "postcode": "SW1A 0AA",
      "country": "UK"
    }
  }
}
```

### Response
#### Success Response (200)
- **expectedDeliveryDate** (string) - The estimated date of delivery in YYYY-MM-DD format.
- **success** (boolean) - Indicates if the request was successful.

#### Response Example
```json
{
  "expectedDeliveryDate": "2024-12-15",
  "success": true
}
```
```

--------------------------------

### POST /orders - Fetch Orders by References

Source: https://www.postman.com/tradeprint/tradeprint-api-s-public-workspace/collection/wal5636/tradeprint-api-sandbox/index

Retrieve orders based on a list of order references. This endpoint is useful for querying specific orders that you have already placed.

```APIDOC
## POST /orders - Fetch Orders by References

### Description
Retrieves orders based on a provided list of order references.

### Method
POST

### Endpoint
/orders

### Parameters
#### Request Body
- **references** (array) - Required - A list of order reference numbers to fetch.
  - **reference** (string) - Required - An order reference number.

### Request Example
```json
{
  "references": [
    "ORDER12345",
    "ORDER67890"
  ]
}
```

### Response
#### Success Response (200)
- **orders** (array) - A list of orders matching the provided references.
  - **orderId** (string) - The unique identifier for the order.
  - **reference** (string) - The reference number of the order.
  - **status** (string) - The current status of the order.
  - **orderDate** (string) - The date the order was placed.
- **success** (boolean) - Indicates if the request was successful.

#### Response Example
```json
{
  "orders": [
    {
      "orderId": "o_1a2b3c",
      "reference": "ORDER12345",
      "status": "Shipped",
      "orderDate": "2024-11-01"
    },
    {
      "orderId": "o_4d5e6f",
      "reference": "ORDER67890",
      "status": "Processing",
      "orderDate": "2024-11-05"
    }
  ],
  "success": true
}
```
```
Tokens:
Raw