GET
/
v3
/
orders
/
status
/
{orderUUID}
Order Status
curl --request GET \
  --url https://sandbox-api.cardcash.com/v3/v3/orders/status/{orderUUID} \
  --header 'Authorization: Bearer <token>'

​
Overview

Returns the current status of an order by UUID.

​
Request

​
Path Parameters

ParameterTypeRequiredDescription
orderUUIDstringYesOrder UUID
curl https://sandbox-api.cardcash.com/v3/orders/status/ORDER_UUID \
  -H "x-cc-app: YOUR_APP_ID" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

{
  "order": {
    "orderId": 12345,
    "uuid": "order-uuid",
    "type": "buy",
    "amount": "91.50",
    "paymentType": "ACH",
    "datePurchased": "2026-01-15T12:00:00.000Z",
    "paymentStatus": "Digitally Delivered",
    "statusText": "Digitally Delivered",
    "lastStatusUpdate": "2026-01-15T12:05:00.000Z",
    "canCancel": false,
    "cards": [
      {
        "merchant": "Target",
        "faceValue": 50.00,
        "cashValue": 45.75,
        "image": "https://cdn.cardcash.com/merchants/target.png"
      }
    ],
    "customer": {
      "name": "John Doe",
      "street": "123 Main St",
      "city": "New York",
      "state": "NY",
      "postcode": "10001",
      "country": "US",
      "email": "john@example.com"
    }
  }
}

​
Response Fields

FieldTypeDescription
orderIdintegerInternal order number
uuidstringOrder UUID
typestring"buy"
amountstringTotal paid
paymentTypestringPayment method used
datePurchasedstringISO 8601 timestamp
paymentStatusstringPayment/order status display text
statusTextstringOrder status display text (or null)
lastStatusUpdatestringTimestamp of last status change
canCancelbooleanWhether the order can be cancelled
cardsarraySummary of cards in order
customerobjectCustomer address on the order

​
Order Not Found

If no order matches the UUID: 
{
  "message": ["no order status found"]
}
Status: 400

​
Order Status Values

The API returns status as display text, not numeric codes. The status field (on list/detail endpoints) and statusText field (on the status endpoint) will contain one of these values:
StatusMeaning
CheckoutCheckout process started
PendingWaiting for payment to clear (e.g., ACH)
ProcessingOrder received and being worked on
FulfillmentOrder is being prepared for shipment
Digitally DeliveredE-code delivered digitally
ShippedPhysical cards shipped (1-7 business days from NJ)
CanceledOrder canceled or declined
HoldIssue with order — contact support
ReviewAwaiting verification

​
Status Groups

GroupStatus ValuesMeaning
In ProgressProcessing, Fulfillment”Your order is being prepared”
PendingCheckout, Pending”Waiting for payment to clear”
CompleteDigitally Delivered, Shipped”Your cards are ready / on the way”
CanceledCanceled”Order was not fulfilled”
Needs AttentionHold, Review”Contact support”

​
Terminal vs. Non-Terminal

  • Terminal statuses (order is done): Digitally Delivered, Shipped, Canceled
  • Non-terminal (keep polling): everything else
There are no webhooks for order status changes. Poll GET /orders/status/:uuid to track order progress.