GET /api/v1/orders/status

Description

Retrieve the current status of an order. This API provides information about order fulfillment status.

Headers

Authorization required

Bearer token received after successful OTP verification. Format: Bearer <jwt-token>

Query Parameters

order_id required, type: string

The unique order identifier.

Example Request

GET /api/v1/orders/status?order_id=ORD123456
Authorization: Bearer <jwt-token>

Example Response

{
  "order_id": "ORD123456",
  "status": "FULFILLED",
  "reward_name": "Amazon Gift Voucher",
  "fulfilled_date": "2026-06-03T10:15:00Z"
}

Response Fields

order_id type: string

The unique order identifier.

status type: string

Current order status (e.g., PENDING, PROCESSING, FULFILLED, FAILED, CANCELLED).

reward_name type: string

Name of the redeemed reward.

fulfilled_date type: datetime

ISO 8601 timestamp of when the order was fulfilled (only present for fulfilled orders).

Order Statuses

  • PENDING: Order received, awaiting processing
  • PROCESSING: Order is being processed
  • FULFILLED: Order successfully completed
  • FAILED: Order fulfillment failed
  • CANCELLED: Order was cancelled