techrar docs
Home
Solutions
Solutions
  • eCommerce SaaS
  • Meals SaaS
  • Meals Marketplaces
API
API
  • Merchant APIs
  • Customer App APIs
  • Meals APIs
Techrar Connect
Home
Solutions
Solutions
  • eCommerce SaaS
  • Meals SaaS
  • Meals Marketplaces
API
API
  • Merchant APIs
  • Customer App APIs
  • Meals APIs
Techrar Connect
  1. Fulfillments
  • Getting Started
  • Merchant Account
    • Merchant Wallet
      • Wallet Details
      • Charge Wallet
    • Merchant Settings
    • List Bank Accounts
    • Update Merchant Settings
    • Organization Config
  • Customers
    • Locations
      • List Customer Locations
      • Customer Location Details
      • Create Customer Location
    • Memberships
      • List Customer Memberships
    • Customer Order Statistics
    • List Customers
    • Customer Details
    • Create Customer
    • Update Customer
  • Wallets
    • Customer Wallet Details
    • Deposit Points
    • Deposit Cashback
    • Redeem from Wallet
  • Vouchers
    • Get Voucher Discount
    • Update Voucher Usage
  • Items
    • Item Config Details
    • Update Item Config
    • List Items
    • Item Details
    • Create Item
    • Update Item
    • Delete Item
    • Reserve an item
    • Record Item Purchase
    • Bulk Update Items
    • Bulk Update Item Prices
  • Item Categories
    • List Item Categories
    • Item Category Details
    • Create Category
    • Update Category
    • Delete Category
  • Item Tags
    • List Item Tags
    • Create Tag
    • Update Tag
    • Delete Tag
  • Item Images
    • Create Item Image
    • Upadte Item Image
    • Delete Item Image
  • Item Discounts
    • Create Item Discount
    • Upadte Item Discount
    • Delete Item Discount
  • Item Bundles
    • List Bundle Categories
    • Bundle Category Details
    • Create Bundle Category
    • Update Bundle Category
    • Delete Bundle Category
  • Item Modifiers
    • List Modifier Categories
    • Modifier Category Details
    • Create Modifier Category
    • Update Modifier Category
    • Delete Modifier Category
  • Carts
    • List Carts
    • Cart Details
  • Orders
    • Checkout Config Details
    • Update Checkout Config
    • List Orders
    • Order Details
    • List Recurring Purchases
    • Recurring Purchase Details
    • Recurring Purchase Details
  • Invoices
    • Invoice Config Details
    • Update Invoice Config
    • List Invoices
    • Invoice Details
    • Refund Invoice
  • Transactions
    • List Transactions
    • Transaction Details
    • Capture Bank Transfer Transaction
    • Decline Bank Transfer Transaction
  • Subscriptions
    • List Subscriptions
    • Subscription Details
    • Subscriptions Statistics
    • Cancel Subscription Auto Renewal
    • Cancel Subscription
    • Increment Subscription Usage
    • Decrement Subscription Usage
    • Bulk Pause Subscriptions
    • Bulk Resume Subscriptions
    • Create Subscription Update
    • Cancel Subscription Update
  • Fulfillments
    • Fulfillment Overview
      GET
    • List Fulfillments
      GET
    • Fulfillment Details
      GET
    • Update Fulfillment Details
      PATCH
  • Tickets
    • List Tickets
    • Bulk Update Tickets
    • Validate Token and Check in Ticket
  • Shipments
    • Shipping Config Details
    • Update Shipping Config
    • Shipping Labels Details
    • Purchase Shipment Labels
    • Create Shipment
    • Cancel Shipment
    • Create Return Shipment
  • Pickup Locations
    • List Pickup Locations
    • Pickup Location Details
    • Create Pickup Location
    • Update Pickup Location Details
    • Delete Pickup Location
  • Couriers
    • List Couriers
    • Get Active Couriers
    • Get Couriers Prices
    • Courier Details
    • Create Custom Courier
    • Update Custom Courier Details
    • Delete Custom Courier
  • Geo & Places
    • List Countires
    • List Regions
    • List Cities
    • List Districts
  • Webhooks
    • List Webhooks
    • Create Webhook
    • Update Webhook Details
    • Delete Webhook
    • List Webhook Logs
    • Test Webhook
    • Delete Webhook By URL
  • Sales Channels
    • Meals
      • List Provider Meal Plans
      • Update Meals Plans Listings
      • List Provider Meals Orders
      • Provider Meals Order Details
      • List Provider Meals Subscriptions
      • Provider Meals Subscription Details
    • Sales Channel Profile Details
    • List Sales Channel Connections
    • Accept Sales Channel Connection Request
    • Reject Sales Channel Connection Request
    • Activate Sales Channel Connection
    • Deactivate Sales Channel Connection
    • Delete Sales Channel Connection Request
  • Notifications
    • Send Notification
  • Meals Plans
    • List Plan Tags
    • List Plans
    • Plan Details
    • Menu Details
  • Meals Logistics
    • City Details
    • Captain Details
    • Branch Details
    • List Supported Windows
    • List Captains
    • Bulk Update SubOrders
  1. Fulfillments

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 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 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
Previous
Fulfillment Overview
Next
Fulfillment Details
Built with