List Couriers

GET

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

This endpoint allows you to list all merchant couriers

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 ********************

Query Params

Header Params

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.techrar.com/order/v1/merchant/shipments/couriers/?search=&page=1&page_size=5&order_by=' \
--header 'app-id: 4' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "count": 10,
    "next": "http://localhost/order/v1/merchant/shipments/couriers/?order_by=&page=2&page_size=5&search=",
    "previous": null,
    "results": [
        {
            "id": 10,
            "custom_fields": null,
            "is_custom": true,
            "is_active": true,
            "shipping_price": 17.0,
            "shipping_max_free_weight": 10.0,
            "shipping_pricing_model": "fixed",
            "shipping_extra_weight_price": 0.0,
            "return_fees": 0.0,
            "total_label_price": 0.0,
            "label_pricing_model": "fixed",
            "label_price": 0.0,
            "label_max_free_weight": 0.0,
            "label_extra_weight_price": 0.0,
            "name": "Custom SMSA",
            "logo": null,
            "service_method": "express_delivery",
            "delivery_method": "to_customer_doorstep",
            "pickup_method": "pickup_by_courier_or_dropoff",
            "delivery_time": "1_to_4_days",
            "pickup_cutoff_time": "12:00:00",
            "country_code": null,
            "city": null,
            "contact_email": "[email protected]",
            "contact_phone": "0534501056"
        },
        {
            "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"
        },
        {
            "id": 8,
            "custom_fields": null,
            "is_custom": false,
            "is_active": false,
            "shipping_price": 0.0,
            "shipping_max_free_weight": 10.0,
            "shipping_pricing_model": "fixed",
            "shipping_extra_weight_price": 0.0,
            "return_fees": 0.0,
            "total_label_price": 50.0,
            "label_pricing_model": "fixed",
            "label_price": 50.0,
            "label_max_free_weight": 10.0,
            "label_extra_weight_price": 0.0,
            "name": "Flow PL",
            "logo": "https://storage.googleapis.com/tryoto-public/delivery-logo/flow.png",
            "service_method": "heavy_bulky_delivery",
            "delivery_method": "to_customer_doorstep",
            "pickup_method": "pickup_by_courier",
            "delivery_time": "1_to_5_days",
            "pickup_cutoff_time": "15:59:22",
            "country_code": null,
            "city": null,
            "contact_email": null,
            "contact_phone": null
        },
        {
            "id": 7,
            "custom_fields": null,
            "is_custom": false,
            "is_active": true,
            "shipping_price": 0.0,
            "shipping_max_free_weight": 10.0,
            "shipping_pricing_model": "fixed",
            "shipping_extra_weight_price": 0.0,
            "return_fees": 0.0,
            "total_label_price": 19.0,
            "label_pricing_model": "fixed",
            "label_price": 19.0,
            "label_max_free_weight": 10.0,
            "label_extra_weight_price": 0.0,
            "name": "Careem",
            "logo": "https://storage.googleapis.com/tryoto-public/delivery-logo/careem.png",
            "service_method": "bullet_delivery",
            "delivery_method": "to_customer_doorstep",
            "pickup_method": "pickup_by_courier",
            "delivery_time": "within_2_hours",
            "pickup_cutoff_time": null,
            "country_code": "SA",
            "city": "Riyadh",
            "contact_email": null,
            "contact_phone": null
        },
        {
            "id": 6,
            "custom_fields": null,
            "is_custom": false,
            "is_active": false,
            "shipping_price": 0.0,
            "shipping_max_free_weight": 10.0,
            "shipping_pricing_model": "fixed",
            "shipping_extra_weight_price": 0.0,
            "return_fees": 0.0,
            "total_label_price": 21.0,
            "label_pricing_model": "fixed",
            "label_price": 21.0,
            "label_max_free_weight": 10.0,
            "label_extra_weight_price": 0.0,
            "name": "Naqel Express",
            "logo": "https://storage.googleapis.com/tryoto-public/delivery-logo/naqel.png",
            "service_method": "express_delivery",
            "delivery_method": "to_customer_doorstep",
            "pickup_method": "pickup_by_courier",
            "delivery_time": "1_to_2_days",
            "pickup_cutoff_time": null,
            "country_code": null,
            "city": null,
            "contact_email": "[email protected]",
            "contact_phone": "0534501056"
        }
    ]
}

Modified at 2025-06-30 19:02:10

Couriers

Get Active Couriers