GET /trending/orders/:orderId
Fetch one order. Only the end user's own orders are visible; an
order that belongs to someone else answers 404, the same as one
that does not exist.
Use case
Poll an order after creating it to see its progress.
Headers
| Header | Required | Description |
|---|---|---|
Authorization | yes | Bearer <accessToken> |
x-user-id | yes | End-user id, 1–256 chars [A-Za-z0-9_-]. |
Path params
| Param | Required | Description |
|---|---|---|
orderId | yes | The orderId from POST /trending/orders. A 24-char hex id. |
Response 200
{ "order": { "orderId": "…", "providerOrderId": "…" } }
Same shape as order in POST /trending/orders.
Errors
| Status | Meaning |
|---|---|
400 | orderId is not a valid id. |
401 / 403 | Token missing, invalid, expired or revoked / API inactive. |
404 | Order not found — missing, or not this user's. |
429 | Per-client rate limit hit. |
503 | Trending disabled or unavailable. |
Example
curl -H "Authorization: Bearer $ACCESS" -H "x-user-id: $USER_ID" \
"$BASE_URL/trending/orders/<orderId>"