Get Gift Card Brands

The Get Gift Card Brands endpoint returns a complete catalog of gift card brands available through the Netevia platform. Each brand entry includes its name, discount rates, logo URL, supported denominations, and face value limits. Partners use this endpoint to build gift card marketplaces or catalogs within their own applications.

Endpoint

GET /api/giftCards/brands

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint when building a gift card purchasing experience within your platform. By fetching available brands before presenting the purchase UI, you can display brand logos, highlight discounts, and restrict purchasable denominations to those supported by each brand. This is typically called once on page load or catalog refresh to keep the displayed brand list current.

Response

200 OK

Returns an array of brand objects.

Brand object (banking.models.giftcards.brandinfo)

[
  {
    "id": "brand-001",
    "name": "Amazon",
    "description": "Shop millions of items on Amazon.com",
    "logoUrl": "https://cdn.netevia.com/giftcards/logos/amazon.png",
    "giftCardUrl": "https://www.amazon.com/gift-cards",
    "digitalFaceValueLimits": {
      "lower": 5.00,
      "upper": 500.00,
      "minorUnit": 1.00
    },
    "digitalDenominations": [10.00, 25.00, 50.00, 100.00],
    "clientDiscount": 0.05,
    "rewardsDiscount": 0.07,
    "categories": ["Retail", "Online Shopping"]
  },
  {
    "id": "brand-002",
    "name": "Walmart",
    "description": "Use at any Walmart store or Walmart.com",
    "logoUrl": "https://cdn.netevia.com/giftcards/logos/walmart.png",
    "giftCardUrl": "https://www.walmart.com/gift-cards",
    "digitalFaceValueLimits": {
      "lower": 5.00,
      "upper": 250.00,
      "minorUnit": 1.00
    },
    "digitalDenominations": [25.00, 50.00, 100.00],
    "clientDiscount": 0.03,
    "rewardsDiscount": 0.05,
    "categories": ["Retail", "Grocery"]
  }
]

Error Codes

Common Mistakes

• Not refreshing the brand list periodically — brands, discounts, and available denominations can change; cache the list with a reasonable TTL rather than hardcoding it.
• Ignoring digitalFaceValueLimits — when allowing customers to enter a custom amount, validate the input against lower, upper, and minorUnit before submitting a purchase request to avoid validation errors downstream.
• Displaying clientDiscount as a percentage without conversion — the value is a decimal (e.g., 0.05 means 5%); multiply by 100 before showing it in the UI.
• Assuming all brands have digitalDenominations — some brands support open-range amounts within digitalFaceValueLimits and may return an empty or null denominations array.

Related Endpoints

• POST /api/giftCards/order — Place an order to purchase a gift card for a specific brand
• GET /api/giftCards/orders — Retrieve the history of gift card orders for a customer
• POST /api/rewards/redeem — Redeem rewards points, optionally toward a gift card purchase

Example

curl -X GET https://api.banking.netevia.dev/api/giftCards/brands \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"