smsaexpress.com APIwww.smsaexpress.com ↗
Track SMSA Express shipments by AWB number. Returns status, delivery details, and tracking events for one or multiple shipments in a single request.
curl -X POST 'https://api.parse.bot/scraper/bbefb5fe-6810-4dba-9726-6bea4f024e8f/track_shipment' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{}'Track one or more shipments by their SMSA Express tracking numbers (AWB numbers). Returns shipment status and tracking details for each valid tracking number found. Multiple tracking numbers can be provided separated by commas or spaces.
| Param | Type | Description |
|---|---|---|
| language | string | Language for tracking response. Accepts: EN, AR, FR. |
| tracking_numbersrequired | string | One or more SMSA Express tracking numbers (AWB numbers), separated by commas or spaces (e.g. '290019498498' or '290019498498,290019934499'). |
{
"type": "object",
"fields": {
"shipments": "array of shipment tracking results (empty if no shipments found)",
"total_found": "integer count of shipments found",
"tracking_numbers": "array of tracking numbers that were queried"
},
"sample": {
"shipments": [],
"total_found": 0,
"tracking_numbers": [
"290019498498"
]
}
}About the smsaexpress.com API
The SMSA Express API provides 1 endpoint — track_shipment — that returns real-time shipment status and tracking details for one or more AWB numbers in a single call. Submit a comma- or space-separated list of SMSA Express tracking numbers and receive a structured array of shipment results alongside a total_found count, making it straightforward to monitor multiple packages at once without issuing repeated requests.
Endpoint: track_shipment
The track_shipment endpoint accepts one or more SMSA Express AWB numbers via the tracking_numbers parameter. Numbers can be separated by commas or spaces, so a single request like 290019498498, 290019498499 is valid. The response returns a shipments array containing tracking results for each valid number found, a total_found integer reflecting how many shipments were matched, and a tracking_numbers array echoing back the queried values for easy reconciliation on your end.
Language Support
The optional language parameter accepts EN, AR, or FR, controlling the language of status descriptions and any human-readable fields in the response. This is useful for applications serving Arabic-speaking markets in Saudi Arabia and the Gulf region, where SMSA Express primarily operates.
Response Shape and Coverage
When tracking numbers are valid and found, each entry in the shipments array carries shipment status and tracking details for that AWB. If no shipments are located — for example, if a tracking number is invalid or not yet in the system — the shipments array returns empty and total_found is 0. There is no partial-failure envelope; all matched results appear together in a single response.
- Automate post-purchase delivery notifications by polling
track_shipmentwith customer AWB numbers - Build a multi-shipment dashboard that batches AWBs into a single request and maps
total_foundto order fulfillment status - Flag delayed or undelivered shipments by comparing current status fields against expected delivery windows
- Support Arabic-speaking customers by setting
language=ARto return status descriptions in Arabic - Reconcile third-party logistics records against SMSA tracking data using the echoed
tracking_numbersarray in each response - Integrate SMSA Express tracking into an e-commerce order management system to surface shipment status without manual portal lookups
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does SMSA Express have an official developer API?+
What does the track_shipment endpoint return when a tracking number is not found?+
shipments array is empty and total_found returns 0. The tracking_numbers field still echoes back whatever values were submitted, so you can identify which numbers failed to resolve.Can I retrieve shipment history or event timelines through this API?+
track_shipment response. Detailed event-by-event movement history (individual scan timestamps and location logs) is not currently a discrete field in the response. You can fork this API on Parse and revise it to surface granular transit event data if your use case requires it.Does the API support tracking numbers from other carriers or only SMSA Express AWBs?+
shipments array. You can fork the API on Parse and revise it to add endpoints for additional carriers if needed.Is there a limit to how many tracking numbers can be submitted in one request?+
tracking_numbers parameter accepts multiple AWBs separated by commas or spaces in a single request. No explicit upper bound on the number of AWBs per call is documented in the endpoint spec; in practice, very large batches may affect response time and completeness.