GET
/
v3
/
carts
Get Cart
curl --request GET \
  --url https://sandbox-api.cardcash.com/v3/v3/carts \
  --header 'Authorization: Bearer <token>'

​
Overview

Returns the current active buy cart, including all cards and any applied coupon.

​
Request

curl https://sandbox-api.cardcash.com/v3/carts \
  -H "x-cc-app: YOUR_APP_ID" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

{
  "cart": {
    "customerId": "customer-uuid",
    "buyCart": {
      "cartId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "cards": [
        {
          "id": "card-uuid-001",
          "merchant": 123,
          "merchantName": "Target",
          "merchantImage": "https://cdn.cardcash.com/merchants/target.png",
          "balance": 50.00,
          "cost": 45.75,
          "quantity": 2,
          "percentOff": 8.5,
          "type": "ecode",
          "isLowRisk": true
        }
      ],
      "couponData": null
    }
  }
}

​
Response Fields

​
Cart Object

FieldTypeDescription
cartIdstringCart UUID — use this for all cart operations
cardsarrayCards currently in the cart
couponDataobject|nullApplied coupon details, or null

​
Cart Card

FieldTypeDescription
idstringCard UUID within the cart
merchantintegerMerchant ID
merchantNamestringMerchant display name
merchantImagestringMerchant logo URL
balancenumberFace value
costnumberPrice after discount
quantityintegerNumber of cards of this type
percentOffnumberDiscount percentage
typestringCard type (physical, ecode, newEcodeB2B, etc.)
isLowRiskboolean|nullWhether card is from a trusted seller

​
Coupon Data (when applied)

FieldTypeDescription
idintegerCoupon ID
typestringP (percentage), F (fixed credit), S (promo credit)
couponstringCoupon code
totalAmountnumberCoupon amount
discountnumberActual discount applied
descriptionstringDisplay text (e.g., “10% OFF”)
expiresstringExpiry date (MM/DD/YYYY)
cardsarrayPer-card discount breakdown

​
Notes

  • If no cart exists, buyCart will be an empty object {}
  • Only one active buy cart per account at a time