ZEMLOG

English

Türkçe

English

Türkçe

Appearance

Calculate Price​

POST
/api/v1/shipment/price-calculations

Lists your organization's carrier quotes for the destination and package dimensions, from cheapest to most expensive.

Parameters​

Header Parameters

Authorization*

Token returned by the Get Token request, with the Bearer prefix

Typestring
Required
Example"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.signature"
Accept-Language

Language of the name fields in the response (country, unit of measure, status and package additional fee names) and of validation messages. English when it starts with en (e.g. en, en-US), Turkish otherwise. Success, business rule, authorization and 503 messages are always in Turkish.

Typestring
Examples
"tr"
"en"
Default"tr"

Request Body​

application/json
JSON
{
"countryId": 3,
"city": "NEW YORK",
"zipCode": "10001",
"carrierId": 1,
"date": "2026-10-10T09:00:00+03:00",
"packages": [
{
"length": 10,
"size": 10,
"height": 10,
"weight": 10,
"piece": 3
}
]
}

Responses​

Price calculated. Quotes are sorted from cheapest to most expensive. Top-level amount fields (freightPrice … total) are returned only if the user who created the application has the Price Calculation permission; with only the Shipments permission, the carrier, volumetric weight and package additional fees (including their amounts) are returned. Zero-value surcharge items (fuelSurcharge, surgeEmergencyFee, fuelSurgeEmergencyFee, totalAdditionalFee, remoteAreaPrice, peakPrice) are omitted from the response.

application/json
JSON
{
"success": true,
"message": "Fiyat hesaplandı",
"items": [
{
"carrier": {
"id": 1,
"name": "UPS",
"service": "Express Saver",
"logoUrl": "https://cdn.zemlog.com/other/carrier_ups_saver_logo_1.png"
},
"totalDesi": 30,
"packages": [
{
"length": 10,
"size": 10,
"height": 10,
"weight": 10,
"desi": 10,
"additionalFees": [
{
"slug": "FREIGHT_WEIGHT_GREATER_THAN_25KG",
"name": "Extra fee added for weight greater than 25 kg",
"amount": 12.5
}
]
}
],
"freightPrice": 94.87,
"fuelSurcharge": 18.6,
"surgeEmergencyFee": 3.2,
"fuelSurgeEmergencyFee": 0.63,
"totalAdditionalFee": 12.5,
"remoteAreaPrice": 35,
"peakPrice": 15,
"sccMinPrice": 5,
"sccDifferencePercentage": 20,
"total": 179.8
}
]
}

Playground​

Headers
Body

Samples​

cURL
JavaScript
PHP
Python