Get Active Couriers

POST

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

This endpoint allows you to get all courier options before checkout.
The list changes based on the passed city, district, location, and cart

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/active/' \
--header 'app-id: 4' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "city_en": "Jeddah",
    "lat": "21.590375041386423000",
    "lng": "39.152816252744530000",
    "district_en": "As Salamah",
    "fulfillment_order_id": 321,
    "pickup_location_id": 1,
    "weight": 2,
    "package_count": 2
}'

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 2025-07-23 09:01:52

List Couriers

Get Couriers Prices