List Fulfillments

GET

https://api.techrar.com/order/v1/merchant/fulfillments/

This endpoint allows you to list all merchant fulfillment orders

Permission

can_read_order - orders read only

Filters

You can filter fulfillment orders with almost all the fields in the fulfillment order e.g. service_type, status, ..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/fulfillments/?search=&search=&page=1&page_size=5&order_by=' \
--header 'app-id: 4' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "count": 14,
    "next": "http://localhost/order/v1/merchant/fulfillments/?order_by=&page=2&page_size=5&search=",
    "previous": null,
    "results": [
        {
            "id": 298,
            "created_at": "2025-07-13T12:38:04.891591+03:00",
            "order_id": 351,
            "invoice_id": 431,
            "status": "ready_for_pickup",
            "customer": {
                "id": 1,
                "country_code": "966",
                "username": "0534501056",
                "mobile_number": "966534501056",
                "email": "[email protected]",
                "name": "Safwan Saigh",
                "lang": "en",
                "current_city_id": 1,
                "is_email_verified": true,
                "is_mobile_verified": true,
                "is_blocked": false,
                "is_deleted": false,
                "is_verified": true,
                "national_id": "1111782031",
                "secondary_mobile_number": "0534501056",
                "date_of_birth": "1999-02-25",
                "avatar": "/media/uploads/customer/avatars/2024/07/29/12048986-a1b6-4e1d-9b8a-216331f3cd71.png",
                "joined_at": "2022-03-12T14:51:15.115924Z",
                "custom_fields": null
            },
            "date": null,
            "time": null,
            "service_type": "delivery",
            "location": {
                "id": 2,
                "custom_fields": null,
                "on_demand_supported": false,
                "subscription_supported": false,
                "location_url": "https://maps.google.com/?q=21.5786337,39.1536752",
                "city": {
                    "id": 1,
                    "custom_fields": null,
                    "app_id": null,
                    "created_at": "2022-03-12T16:51:57.964819+03:00",
                    "modified_at": "2023-02-19T18:29:28.335083+03:00",
                    "is_deleted": false,
                    "deleted_at": null,
                    "ordering": 0,
                    "name_ar": "جده",
                    "name_en": "Jeddah",
                    "country_code": "SA",
                    "keywords": "Jeddah,jeddah,جدة,جده",
                    "is_supported": true
                },
                "app_id": null,
                "created_at": "2022-04-13T15:16:55.721015+03:00",
                "modified_at": "2025-01-28T17:13:30.592617+03:00",
                "is_deleted": false,
                "deleted_at": null,
                "ordering": 0,
                "name_ar": "home",
                "name_en": "home",
                "longitude": "39.1536752",
                "latitude": "21.5786337",
                "address1": "6438 ابن عديس، حي السلامة، جدة 23436 3083، السعودية",
                "address2": "جدة",
                "place_id": "ChIJ7SIhYS7bwxURWDIHU_Wzggk",
                "postal_code": "23436",
                "formatted_address": "ابن عديس، 6438 ibn Udays st. - al-salamh-dist jeddah 3083-23436 Villa 16، جدة 23436،، As Salamah, Jeddah 23436, Saudi Arabia",
                "district": "As Salamah",
                "district_ar": null,
                "city_name_en": "Jeddah",
                "city_name_ar": null,
                "route": null,
                "street_number": null,
                "is_synced": true,
                "type": "home",
                "description": "عماره ٢٢، شقه ٣",
                "is_default": false,
                "image": "/media/uploads/location/images/2025/01/28/61ebe418-7fb0-4d4c-9e73-7a417997e713.png",
                "deleted_from": null,
                "zone": 1,
                "customer_profile": 1
            },
            "pickup_location": null,
            "city_en": "Jeddah",
            "city_ar": "جدة",
            "district_en": "As Salamah Dist.",
            "district_ar": "حي السلامة",
            "selected_courier_id": null,
            "shipments": [
                {
                    "id": 16,
                    "custom_fields": null,
                    "courier_id": 1,
                    "courier_name": "OTO Flex",
                    "events": [
                        {
                            "created_at": "2025-07-13T23:33:37.305212+03:00",
                            "status": "pending",
                            "note": null,
                            "provider_status": "assignedToWarehouse"
                        },
                        {
                            "created_at": "2025-07-13T23:33:38.957156+03:00",
                            "status": "ready_for_pickup",
                            "note": null,
                            "provider_status": "searchingDriver"
                        }
                    ],
                    "tracking_number": "163db926",
                    "tracking_url": "http://localhost:8000/order/v1/shipments/16/track/",
                    "label_url": "https://staging-api.tryoto.com/print/awb?enc=eyJjb21wYW55SWQiOjM4NzA0LCJpZHMiOl

Modified at 2025-07-06 14:19:13

Fulfillment Overview

Fulfillment Details