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

​
Overview

Returns a list of all merchants with available gift card inventory. This is the bulk/partner variant that includes additional fields like physicalAvailable, lowRiskPOAvailable, and per-card-type discount info.
This endpoint requires login. For public (unauthenticated) merchant listing, use GET /v3/merchants/buy instead.

​
Request

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

​
Response

Returns an array of merchant objects: 
[
  {
    "id": 123,
    "name": "Target",
    "image": "https://cdn.cardcash.com/merchants/target.png",
    "slug": "target",
    "primaryColor": "#CC0000",
    "aliases": ["Target Store", "SuperTarget"],
    "cardsAvailable": 45,
    "preownedAvailable": 45,
    "physicalAvailable": 20,
    "ecodesAvailable": 30,
    "lowRiskPOAvailable": 15,
    "minFaceValue": 10,
    "maxFaceValue": 500,
    "minPercOff": 3.5,
    "maxPercOff": 8.5,
    "maxEcodePercOff": 7.2,
    "newAvailable": true
  }
]

​
Response Fields

FieldTypeDescription
idintegerMerchant identifier
namestringDisplay name
imagestringMerchant logo URL
slugstringURL-friendly name
primaryColorstringBrand color (hex)
aliasesstring[]Alternative names for search matching
cardsAvailableintegerTotal cards in stock
preownedAvailableintegerPre-owned cards available
physicalAvailableintegerPhysical cards available
ecodesAvailableintegerE-code (digital) cards available
lowRiskPOAvailableintegerCards from trusted sellers with verified balances
minFaceValuenumberMinimum face value available
maxFaceValuenumberMaximum face value available
minPercOffnumberMinimum discount percentage
maxPercOffnumberMaximum discount percentage across all types
maxEcodePercOffnumberMaximum discount for e-codes specifically
newAvailablebooleanWhether new (non-pre-owned) cards are available

​
Card Types

TypeDescription
physicalPhysical gift card (shipped)
ecodeDigital gift card delivered electronically

​
Notes

  • Results are cached for 60 seconds
  • Merchants with zero inventory are still returned (check cardsAvailable)
  • When newAvailable is true, new card inventory is assumed to be unlimited. If planning a very large purchase of new cards, contact your account manager in advance.