Docs API & Developer GET /api/v1/gift-cards

GET /api/v1/gift-cards

List gift cards issued by your business with balance and status.


GET /api/v1/gift-cards

Returns paginated gift cards issued by your business.

Query parameters

ParameterTypeDescription
statusstringactive, redeemed, or expired
per_pageintegerResults per page (max 100)

Request

curl -X GET "https://app.6xcom.com/api/v1/gift-cards?status=active" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Response

{
  "data": [
    {
      "id": 5,
      "code": "GC-XKDF-9821",
      "initial_amount": 50.00,
      "current_balance": 32.50,
      "status": "active",
      "expires_at": "2027-01-01",
      "issued_at": "2026-06-01T10:00:00.000000Z"
    }
  ],
  "total": 12,
  "per_page": 20,
  "current_page": 1,
  "last_page": 1
}
Was this article helpful?