Admin Operations

1 API call in this section.

Admin-only endpoints for detailed package management

Get Package by ID (Admin)

Express Shipping / Order / Admin Operations

GET/express-shipping/order/{{package_id}}

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.

Requires tenant admin or system admin.

Success (200)

Returns a rich, user-friendly structure.

Path parameters

Parameter	Type	Description
package_idRequired	string	Variable used inside the request path. Variable used inside the request path.
idRequired	string	(uuid, required): Package primary key (uuid, required): Package primary key

Query parameters

Parameter	Type	Description
language	string	Preferred language (en, ar, ku) Preferred language (en, ar, ku) Example: en

Headers

Parameter	Type	Description
Authorization	string	Tenant admin token Tenant admin token Example: Bearer {{access_token}}

Staging

Request

curl

1curl --globoff --request GET "https://staging-api.ondi.io/functions/v1/express-shipping/order/${PACKAGE_ID}?language=en" \2  --header "Authorization: Bearer ${ONDI_ACCESS_TOKEN}"

Response examples

200 · OK - Package Details (Admin)404 · Not Found

200OK - Package Details (Admin)

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}