GET
/
v3
/
merchants
/
{merchantId}
/
inventory
/
bulk
Get Inventory
curl --request GET \
  --url https://sandbox-api.cardcash.com/v3/v3/merchants/{merchantId}/inventory/bulk \
  --header 'Authorization: Bearer <token>'

​
Overview

Returns all available gift card inventory for a given merchant, including individual card IDs, face values, discounts, and risk level. This is the bulk/partner variant with per-card detail.

​
Request

​
Path Parameters

ParameterTypeRequiredDescription
merchantIdintegerYesMerchant identifier
curl https://sandbox-api.cardcash.com/v3/merchants/123/inventory/bulk \
  -H "x-cc-app: YOUR_APP_ID" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

{
  "id": 123,
  "image": "https://cdn.cardcash.com/merchants/target.png",
  "buyMessage": "Digital delivery within minutes",
  "description": "Target gift cards can be used at any Target store...",
  "inventory": [
    {
      "id": "inv-uuid-001",
      "faceValue": 50.00,
      "percentOff": 8.5,
      "cost": 45.75,
      "qty": 3,
      "type": "ecode",
      "isNew": false,
      "isLowRisk": true,
      "tooltipMessages": ""
    },
    {
      "id": "inv-uuid-002",
      "faceValue": 100.00,
      "percentOff": 7.0,
      "cost": 93.00,
      "qty": 5,
      "type": "physical",
      "isNew": false,
      "isLowRisk": false,
      "tooltipMessages": ""
    },
    {
      "id": "123-5000-850",
      "faceValue": 50.00,
      "percentOff": 8.5,
      "cost": 45.75,
      "qty": 10,
      "type": "newEcodeB2B",
      "isNew": true,
      "isLowRisk": true,
      "tooltipMessages": ""
    }
  ]
}

​
Response Fields

​
Top-Level

FieldTypeDescription
idintegerMerchant ID
imagestringMerchant logo URL
buyMessagestringMerchant-specific purchase message
descriptionstringMerchant description
inventoryarrayArray of available cards

​
Inventory Item

FieldTypeDescription
idstringUnique inventory identifier (use when adding to cart)
faceValuenumberFace value of the card
percentOffnumberDiscount percentage
costnumberPrice you pay (faceValue - (faceValue * percentOff / 100))
qtyintegerQuantity available
typestringCard type (see table below)
isNewbooleantrue for new gift cards, false for pre-owned
isLowRiskbooleantrue for cards from trusted sellers (see risk levels)
tooltipMessagesstringAdditional info about the card (may be empty)

​
Inventory Types

TypeDescription
physicalPre-owned physical gift card
ecodePre-owned digital gift card
newEcodeB2B, newEcodeAsPreNew digital gift card sourced from brands/suppliers

​
Card Risk Levels

Cards are categorized by source and verification level. This affects pricing and reliability:
Risk LevelDescriptionPricing
NewSourced directly from brands and authorized suppliers. Highest reliability.Highest (lowest discount)
Low RiskFrom trusted marketplace sellers and verified sources. Rarely have redemption issues. Balance verified.Mid-range
Pre-ownedStandard marketplace cards. Balance verified.Lowest (highest discount)
All low-risk and pre-owned cards are balance verified before sale. New card inventory is assumed to be unlimited — contact your account manager before placing very large new card orders.

​
Notes

  • Pre-owned inventory appears first, followed by new cards
  • New card inventory is cached for 24 hours per merchant
  • An empty inventory array indicates the merchant is currently out of stock
  • The cost field is pre-calculated: faceValue - (faceValue * percentOff / 100)