Skip to main content

Admin Operations

1 API call in this section.

Get Package by ID (Admin)

Express Shipping / Order / Admin Operations
GET/express-shipping/order/{{package_id}}?language=en

API: Get Package by Database ID (Admin) Endpoint: GET /express-shipping/order/{id} Purpose: Tenant admins fetch full package details by primary ID, including user, delivery, inventory, invoice, fee breakdown, and assets. Auth: Requires tenant admin or system admin. Path Parameters: - id (uuid, required): Package primary key Success (200): Returns a rich, user-friendly structure.

Send a bearer token in the Authorization header for an authenticated OnDi user session.
Request
curl
1curl --request GET "$ONDI_BASE_URL/express-shipping/order/{{package_id}}?language=en" \2  --header "Authorization: Bearer {{access_token}}"

Path parameters

package_idRequired
path string

Variable used inside the request path.

Query parameters

languageOptional
query string

en

Preferred language (en, ar, ku)

Headers

AuthorizationOptional
header string

Bearer {{access_token}}

Tenant admin token

Responses

OK - Package Details (Admin)200
Response body
json
1{2  "success": true,3  "data": {4    "id": "0024508a-4029-4e4c-a27e-d49dce13153a",5    "identifiers": {6      "tracking_number": "GL1757318461585",7      "cargo_tracking_code": "AZO593623623",8      "order_id": "GLA1AACB7890"9    },10    "status": {11      "current": "received",12      "history": [13        {14          "status": "received",15          "timestamp": "2025-09-08T08:03:37.078663+00:00"16        }17      ],18      "payment_status": "pending"19    },20    "timestamps": {21      "created_at": "2025-09-08T08:01:03.800289+00:00",22      "updated_at": "2025-09-08T08:03:37.078663+00:00",23      "claimed_at": "2025-09-08T08:01:03.767Z",24      "received_at": "2025-09-08T08:03:36.96+00",25      "delivered_at": null,26      "paid_at": null27    },28    "package": {29      "weight": 1500,30      "quantity": 3,31      "declared_value": 125.5,32      "currency": "IQD",33      "store_name": "Trendyol",34      "hs_code": null,35      "package_type": "general_goods",36      "cargo_info": [37        "1521235ATT35",38        "124125515"39      ]40    },41    "customer": {42      "id": "51061ded-83f5-4fb9-82e6-41f16f507c6e",43      "name": "John Doe",44      "email": "john@example.com",45      "phone": "+964751234567"46    },47    "delivery": {48      "id": "72fceec2-66bd-4234-a0c2-be7942da6eb2",49      "code": "DEL-0001",50      "barcode": "BR-0001",51      "status": "pending",52      "address": {53        "lat": 36.1877,54        "lng": 44.0107,55        "full_address": "123 Main Street..."56      },57      "instructions": null58    },59    "inventory_item": {60      "id": "7399a559-306d-4ffa-8d1b-bcae64edcef2",61      "sku": "GL...-1",62      "name": "Wireless Bluetooth Headphones"63    },64    "invoice": {65      "file_url": "express/invoice/GAL1704067200000/1704067300000-invoice.pdf"66    },67    "fees": {68      "fee_breakdown": {69        "domestic_fee": 20,70        "international_fee": 10.3171      },72      "delivery_fee": 30.31,73      "payment_method": null,74      "payment_transaction_id": null75    },76    "assets": {77      "shipping_label_url": null,78      "delivery_confirmation": null79    }80  }81}
Not Found404
Response body
json
1{2  "success": false,3  "message": "express_shipping_package_not_found"4}