Skip to main content
POST
/
api
/
epo
/
item-pricing
Configure EPO Item Pricing
curl --request POST \
  --url https://1a557de0-701c-477d-bedd-433520441dae.mock.pstmn.io/api/epo/item-pricing \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "epoId": "EPO-123",
  "itemCategories": [
    {
      "categoryCode": "DOCUMENTS",
      "categoryName": "Documents & Papers",
      "serviceLevels": [
        {
          "code": "NEXT_DAY",
          "name": "Next Day Delivery",
          "pricePerItem": 25,
          "basePricePerKg": 5,
          "minimumCharge": 35,
          "maxWeightKg": 30,
          "maxDimensionsCm": {
            "length": 35,
            "width": 25,
            "height": 5
          },
          "volumetricDivisor": 5000,
          "transitTimeHours": 24,
          "specialHandlingOptions": [
            {
              "code": "FRAGILE",
              "surcharge": 10
            }
          ]
        }
      ]
    }
  ],
  "effectiveDate": "2025-01-01",
  "currency": "USD",
  "taxRate": 0.1
}
'
{
  "pricingId": "PRICE-456",
  "status": "CONFIGURED",
  "itemCategoriesConfigured": 2,
  "serviceLevelsConfigured": 4,
  "message": "Item pricing and service levels successfully configured"
}

​
Reference Documentation

For more information on EPO item pricing configuration, please refer to:

Authorizations

​
Authorization
string
header
required

Body

application/json
​
epoId
string
required
Example:

"EPO-123"

​
itemCategories
object[]
required
​
effectiveDate
string<date>
required
Example:

"2025-01-01"

​
currency
string
required
Example:

"USD"

​
taxRate
number
Example:

0.1

Response

200 - application/json

Item pricing and service levels successfully configured

​
pricingId
string
Example:

"PRICE-456"

​
status
string
Example:

"CONFIGURED"

​
itemCategoriesConfigured
integer
Example:

2

​
serviceLevelsConfigured
integer
Example:

4

​
message
string
Example:

"Item pricing and service levels successfully configured"