GET
/
v3
/
orders
/
buy
List Orders
curl --request GET \
  --url https://sandbox-api.cardcash.com/v3/v3/orders/buy \
  --header 'Authorization: Bearer <token>'

​
Overview

Returns a summary list of all buy orders placed by your account.

​
Request

​
Query Parameters

ParameterTypeRequiredDescription
store_specificbooleanNoIf true, only returns orders from your partner store
curl https://sandbox-api.cardcash.com/v3/orders/buy?store_specific=true \
  -H "x-cc-app: YOUR_APP_ID" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

Returns an array of order summaries: 
[
  {
    "id": "order-uuid-001",
    "orderId": 12345,
    "datePurchased": "2026-01-15T12:00:00.000Z",
    "status": "Processing",
    "total": "91.50",
    "trackingData": {
      "id": 1,
      "name": "partner-name",
      "type": "affiliate"
    },
    "cards": {
      "merchants": [123, 456],
      "face_value": 200,
      "cash_value": 183.00,
      "qty": 4
    }
  },
  {
    "id": "order-uuid-002",
    "orderId": 12346,
    "datePurchased": "2026-01-10T09:30:00.000Z",
    "status": "Digitally Delivered",
    "total": "45.75",
    "cards": {
      "merchants": [123],
      "face_value": 50,
      "cash_value": 45.75,
      "qty": 1
    }
  }
]

​
Response Fields

FieldTypeDescription
idstringOrder UUID
orderIdintegerInternal order number
datePurchasedstringISO 8601 timestamp
statusstringOrder status display text (e.g., “Processing”, “Digitally Delivered”)
totalstringTotal amount paid
trackingDataobjectAffiliate/campaign tracking (if applicable)
cards.merchantsinteger[]Merchant IDs in the order
cards.face_valuenumberTotal face value
cards.cash_valuenumberTotal cost
cards.qtyintegerNumber of cards

​
Notes

  • Use store_specific=true to only see orders placed through your partner integration
  • For full order details, use Get Order with the order UUID
  • Results are returned in reverse chronological order (newest first)