How to Check OTO Delivery Fees

Modified on Sun, 2 Feb at 3:15 AM

Our API provides the checkOTODeliveryFee endpoint, allowing users to retrieve available delivery options, pricing, and estimated costs based on shipment details. This guide explains how to check delivery fees before creating a shipment.

Instructions

Step 1: API Endpoint

To check OTO delivery fees, use the following POST endpoint:
```
https://api.tryoto.com/rest/v2/checkOTODeliveryFee
```

Step 2: Authorization

A valid Bearer Token must be included in the request headers for authentication

Step 3: Request Body Parameters

The request body should be in JSON format and must include at least one date filter.

Name	Required	Type	Description
originCity	yes	string	pickup city
destinationCity	yes	string	destination city
originCountry*	no	string	ISO 3166-2 code, "SA","KW" etc.
destinationCountry*	no	string	ISO 3166-2 code, "SA","KW" etc.
weight*	yes	number	approximate weight of package(kg)
currency	no	string	ISO 4217 code, "SAR","KWD", etc.
packageCount	no	number	1
totalDue	no	number	cash on delivery amount
length	no	number	length of the package(cm)
width	no	number	width of the package(cm)
height	no	number	height of the package(cm)
serviceType	no	string	`express`,`sameDay`, `fastDelivery`, `coldDelivery`,`heavyAndBulky`, `electronicAndHeavy`

Step 4: Example Request

Using cURL:

curl --location 'https://api.tryoto.com/rest/v2/checkOTODeliveryFee' \
--data '{
    "weight":"3",
    "originCity":"Riyadh",
    "destinationCity":"Jeddah",
    "height":30,
    "width":30,
    "length":30
}'

Step 5: Example Response

A successful response will return the available delivery options, pricing, and estimated costs:

{
  "traceId": "2e648363-2e85-49b3-9eea-75c9d10c09d0",
  "success": true,
  "deliveryCompany": [
    {
      "serviceType": "express",
      "deliveryOptionName": "Kwick Box",
      "trackingType": "excellent",
      "codCharge": 10,
      "pickupCutOffTime": "17:00",
      "maxOrderValue": 3750,
      "insurancePolicy": "Up To 3500 SAR",
      "maxCODValue": 3750,
      "deliveryOptionId": 345,
      "extraWeightPerKg": 1,
      "deliveryCompanyName": "kwickbox",
      "returnFee": 13,
      "maxFreeWeight": 25,
      "avgDeliveryTime": "1 to 2 Working Days",
      "price": 13,
      "logo": "https://storage.googleapis.com/tryoto-public/delivery-logo/kwickbox.png",
      "pickupDropoff": "freePickup"
    },
    {
      "serviceType": "pudo",
      "deliveryOptionName": "SPL - PUDO",
      "trackingType": "excellent",
      "codCharge": 8,
      "pickupCutOffTime": "12:00",
      "maxOrderValue": 10000,
      "insurancePolicy": "Up To 5000.00 SAR",
      "maxCODValue": 5000,
      "deliveryOptionId": 2748,
      "extraWeightPerKg": 1,
      "deliveryCompanyName": "saudiPost",
      "returnFee": 14,
      "maxFreeWeight": 15,
      "avgDeliveryTime": "1 to 5 Working Days",
      "price": 14,
      "logo": "https://storage.googleapis.com/tryoto-public/delivery-logo/spl.jpg",
      "pickupDropoff": "dropoffOnly"
    },
    {
      "serviceType": "express",
      "deliveryOptionName": "Thabit Logistics",
      "trackingType": "excellent",
      "codCharge": 6,
      "pickupCutOffTime": "17:00",
      "maxOrderValue": 3750,
      "insurancePolicy": "Up To 5000 SAR",
      "maxCODValue": 3750,
      "deliveryOptionId": 645,
      "extraWeightPerKg": 1,
      "deliveryCompanyName": "thabit",
      "returnFee": 19,
      "maxFreeWeight": 10,
      "avgDeliveryTime": "1 to 2 Working Days",
      "price": 19,
      "logo": "https://storage.googleapis.com/tryoto-public/delivery-logo/thabit.png",
      "pickupDropoff": "freePickup"
    },
    {
      "serviceType": "express",
      "deliveryOptionName": "Safe Arrival",
      "trackingType": "excellent",
      "codCharge": 3,
      "pickupCutOffTime": "16:00",
      "maxOrderValue": 3000,
      "insurancePolicy": "Up To 500 SAR",
      "maxCODValue": 3000,
      "deliveryOptionId": 3213,
      "extraWeightPerKg": 1,
      "deliveryCompanyName": "safearrival",
      "returnFee": 19,
      "maxFreeWeight": 10,
      "avgDeliveryTime": "1 to 2 Working Days",
      "price": 19,
      "logo": "https://storage.googleapis.com/tryoto-public/delivery-logo/safearrival.png",
      "pickupDropoff": "freePickup"
    },
    {
      "serviceType": "express",
      "deliveryOptionName": "Aymakan",
      "trackingType": "excellent",
      "codCharge": 6,
      "pickupCutOffTime": "15:00",
      "maxOrderValue": 5000,
      "insurancePolicy": "Up To 375 SAR",
      "maxCODValue": 3000,
      "deliveryOptionId": 994,
      "extraWeightPerKg": 2,
      "deliveryCompanyName": "aymakan",
      "returnFee": 19,
      "maxFreeWeight": 10,
      "avgDeliveryTime": "1 to 3 Working Days",
      "price": 19,
      "logo": "https://storage.googleapis.com/tryoto-public/delivery-logo/aymakan.png",
      "pickupDropoff": "freePickup"
    },
    {
      "serviceType": "express",
      "deliveryOptionName": "DELIVERIST ",
      "trackingType": "excellent",
      "codCharge": 3,
      "pickupCutOffTime": "13:00",
      "maxOrderValue": 3500,
      "insurancePolicy": "Up To 500 SAR",
      "maxCODValue": 3500,
      "deliveryOptionId": 4175,
      "extraWeightPerKg": 1,
      "deliveryCompanyName": "deliveristLogestechs",
      "returnFee": 19,
      "maxFreeWeight": 10,
      "avgDeliveryTime": "1 to 3 Working Days",
      "price": 19,
      "logo": "https://storage.googleapis.com/tryoto-public/delivery-logo/deliverist.png",
      "pickupDropoff": "freePickup"
    },
    {
      "serviceType": "express",
      "deliveryOptionName": "Shipa Delivery",
      "trackingType": "excellent",
      "codCharge": 3,
      "pickupCutOffTime": "14:00",
      "maxOrderValue": 3750,
      "insurancePolicy": "Up To 100 SAR",
      "maxCODValue": 3750,
      "deliveryOptionId": 346,
      "extraWeightPerKg": 1,
      "deliveryCompanyName": "shipaV2",
      "returnFee": 20,
      "maxFreeWeight": 10,
      "avgDeliveryTime": "1 to 3 Working Days",
      "price": 20,
      "logo": "https://storage.googleapis.com/tryoto-public/delivery-logo/shipa.png",
      "pickupDropoff": "freePickup"
    },
    {
      "serviceType": "express",
      "deliveryOptionName": "Aramex",
      "trackingType": "excellent",
      "codCharge": 6,
      "pickupCutOffTime": "18:00",
      "maxOrderValue": 10000,
      "insurancePolicy": "Up To 1000 SAR",
      "maxCODValue": 5000,
      "deliveryOptionId": 332,
      "extraWeightPerKg": 1,
      "deliveryCompanyName": "aramex",
      "returnFee": 21,
      "maxFreeWeight": 10,
      "avgDeliveryTime": "1 to 2 Working Days",
      "price": 21,
      "logo": "https://storage.googleapis.com/tryoto-public/delivery-logo/aramex.png",
      "pickupDropoff": "freePickupDropoff"
    },
    {
      "serviceType": "express",
      "deliveryOptionName": "J&T Express",
      "trackingType": "excellent",
      "codCharge": 8,
      "pickupCutOffTime": "12:00",
      "maxOrderValue": 6000,
      "insurancePolicy": "Up To 400 SAR",
      "maxCODValue": 3000,
      "deliveryOptionId": 711,
      "extraWeightPerKg": 1,
      "deliveryCompanyName": "jtexpress",
      "returnFee": 21,
      "maxFreeWeight": 5,
      "avgDeliveryTime": "1 to 2 Working Days",
      "price": 21,
      "logo": "https://storage.googleapis.com/tryoto-public/delivery-logo/jandt.png",
      "pickupDropoff": "freePickupDropoff"
    },
    {
      "serviceType": "express",
      "deliveryOptionName": "UPS",
      "trackingType": "excellent",
      "codCharge": 8,
      "pickupCutOffTime": "15:00",
      "maxOrderValue": 5000,
      "insurancePolicy": "Up To 375 SAR",
      "maxCODValue": 2000,
      "deliveryOptionId": 1305,
      "extraWeightPerKg": 1,
      "deliveryCompanyName": "ups",
      "returnFee": 22,
      "maxFreeWeight": 15,
      "avgDeliveryTime": "1 to 5 Working Days",
      "price": 22,
      "logo": "https://storage.googleapis.com/tryoto-public/delivery-logo/ups.png",
      "pickupDropoff": "freePickup"
    },
    {
      "serviceType": "express",
      "deliveryOptionName": "SMSA",
      "trackingType": "excellent",
      "codCharge": 8,
      "pickupCutOffTime": "12:00",
      "maxOrderValue": 6000,
      "insurancePolicy": "Up To 100 SAR",
      "maxCODValue": 3750,
      "deliveryOptionId": 979,
      "extraWeightPerKg": 1,
      "deliveryCompanyName": "secom",
      "returnFee": 24,
      "maxFreeWeight": 15,
      "avgDeliveryTime": "1 to 5 Working Days",
      "price": 24,
      "logo": "https://storage.googleapis.com/tryoto-public/delivery-logo/smsav2.png",
      "pickupDropoff": "dropoffOnly"
    },
    {
      "serviceType": "heavyAndBulky",
      "deliveryOptionName": "Flow PL",
      "trackingType": "excellent",
      "codCharge": 0,
      "pickupCutOffTime": "09:00",
      "maxOrderValue": 20000,
      "insurancePolicy": "Up To 500 SAR",
      "maxCODValue": 0,
      "deliveryOptionId": 2567,
      "extraWeightPerKg": 1,
      "deliveryCompanyName": "flowpl",
      "returnFee": 44,
      "maxFreeWeight": 30,
      "avgDeliveryTime": "1 to 5 Working Days",
      "price": 44,
      "logo": "https://storage.googleapis.com/tryoto-public/delivery-logo/flow.png",
      "pickupDropoff": "freePickup"
    },
    {
      "serviceType": "express",
      "deliveryOptionName": "DHL Express MyDHL",
      "trackingType": "excellent",
      "codCharge": 8,
      "pickupCutOffTime": "17:00",
      "maxOrderValue": 3750,
      "insurancePolicy": "Up To 100 SAR",
      "maxCODValue": 1,
      "deliveryOptionId": 1593,
      "extraWeightPerKg": 10,
      "deliveryCompanyName": "mydhl",
      "returnFee": 69,
      "maxFreeWeight": 5,
      "avgDeliveryTime": "1 to 5 Working Days",
      "price": 69,
      "logo": "https://storage.googleapis.com/tryoto-public/delivery-logo/dhl-express.png",
      "pickupDropoff": "freePickupDropoff"
    }
  ]
}