Price Lists - Custom By Id


Endpoint

GET /products/price-lists/custom/{customPriceId}

Authentication

Required: Authorization header with valid token

Query Parameters

ParameterTypeRequiredDescriptionExample
productIdstringNoFilter by product Ide433b04a-2b4d-419a-accc-f1ada3f55b15
typestring (enum)NoFilter by product type (EQUIPMENT, PERSON, SERVICE, INVENTORY)EQUIPMENT
pagenumberNoPage number (default: 1, min: 1)1
limitnumberNoItems per page (default: 20, min: 0)50

Success

{
  "content": [
    "PriceList"
  ],
  "total": "number"
}

Response Field Descriptions:

  • content - Array of PriceList
  • total - Total number of items matching the filter

Data Models & Schemas

PriceList

{
  "id": "string (UUID)",
  "productId": "string (UUID)",
  "productTitle": "string",
  "productNumber": "string",
  "from": 1,
  "productUnit": "string",
  "standardPrice": 100,
  "discount": 10,
  "discountTotal": 10,
  "priceListPrice": 90,
  "discountCalculation": "PRICE",
  "children": [
    "PriceList"
  ]
}

Fields Descriptions

  • id - Unique identifier of the custom price list entry
  • productId - ID of the associated product
  • productTitle - Title of the product
  • productNumber - Product number identifier
  • from - Quantity range start for this pricing tier
  • productUnit - Unit of measurement for the product
  • standardPrice - Standard (base) price for this tier
  • discount - Discount percentage
  • discountTotal - Absolute discount amount
  • priceListPrice - Custom price for this tier
  • discountCalculation - Discount calculation type (PRICE or PERCENTAGE)
  • children - Additional pricing tiers for the same product (nested entries with from > 1)

Example Usage

curl -X GET "https://integration-api.ram.syniotec.com/master-data/v1/product-management/products/price-lists/custom/e433b04a-2b4d-419a-accc-f1ada3f55b15" \
  -H "Authorization: Bearer YOUR_TOKEN"