Get Couriers Prices

POST

https://api.techrar.com/order/v1/merchant/shipments/couriers/prices/

This endpoint allows you to get all courier prices.
The list changes based on the passed origin, destination, and package details.

Permission

can_read_shipment - shipments read only

Filters

You can filter couriers with almost all the fields in the courier e.g. delivery_method, pickup_method, ..etc

Light Objects

In most list endpoints, the returned object will be light.
Use the details endpoint to get a detailed object

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.techrar.com/order/v1/merchant/shipments/couriers/prices/' \
--header 'app-id: 4' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "origin_city": "Jeddah",
    "destination_city": "Jeddah",
    "origin_lat": null,
    "origin_lng": null,
    "destination_lat": null,
    "destination_lng": null,
    "package_count": 2,
    "package_dimensions": {
        "width": 10,
        "length": 10,
        "height": 10
    },
    "weight": 2,
    "is_reversed": false
}'

Response Example

{
    "count": 2,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 1,
            "custom_fields": null,
            "is_custom": false,
            "is_active": true,
            "shipping_price": 17.0,
            "shipping_max_free_weight": 10.0,
            "shipping_pricing_model": "fixed",
            "shipping_extra_weight_price": 1.0,
            "return_fees": 0.0,
            "total_label_price": 16.0,
            "label_pricing_model": "variable",
            "label_price": 16.0,
            "label_max_free_weight": 10.0,
            "label_extra_weight_price": 1.0,
            "name": "OTO Flex",
            "logo": "https://storage.googleapis.com/tryoto-public/delivery-logo/otoflex.png",
            "service_method": "express_delivery",
            "delivery_method": "to_customer_doorstep",
            "pickup_method": "branch_dropoff",
            "delivery_time": "1_to_4_days",
            "pickup_cutoff_time": null,
            "country_code": null,
            "city": null,
            "contact_email": null,
            "contact_phone": null
        },
        {
            "id": 9,
            "custom_fields": null,
            "is_custom": true,
            "is_active": true,
            "shipping_price": 20.0,
            "shipping_max_free_weight": 10.0,
            "shipping_pricing_model": "fixed",
            "shipping_extra_weight_price": 2.0,
            "return_fees": 10.0,
            "total_label_price": 0.0,
            "label_pricing_model": "variable",
            "label_price": 0.0,
            "label_max_free_weight": 10.0,
            "label_extra_weight_price": 0.0,
            "name": "Custom",
            "logo": null,
            "service_method": "express_delivery",
            "delivery_method": "to_customer_doorstep",
            "pickup_method": "branch_dropoff",
            "delivery_time": "1_to_2_days",
            "pickup_cutoff_time": "11:00:00",
            "country_code": null,
            "city": null,
            "contact_email": "[email protected]",
            "contact_phone": "0534501056"
        }
    ]
}

Modified at 2026-06-01 12:39:13

Get Active Couriers

Courier Details