Skip to main content

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​

HeaderRequiredDescription
AuthorizationyesBearer <accessToken>
x-user-idyesEnd-user id, 1–256 chars [A-Za-z0-9_-].

Path params​

ParamRequiredDescription
orderIdyesThe orderId from POST /trending/orders. A 24-char hex id.

Response 200​

{ "order": { "orderId": "…", "providerOrderId": "…" } }

Same shape as order in POST /trending/orders.

Errors​

StatusMeaning
400orderId is not a valid id.
401 / 403Token missing, invalid, expired or revoked / API inactive.
404Order not found — missing, or not this user's.
429Per-client rate limit hit.
503Trending disabled or unavailable.

Example​

curl -H "Authorization: Bearer $ACCESS" -H "x-user-id: $USER_ID" \
"$BASE_URL/trending/orders/<orderId>"