StoredCreditAccount

A stored credit account contains all balance changes.

Retrieve the balance events for a gift card

get

Retrieve all balance transactions for a specific gift card by its code.

Authorizations

x_api_key

x-api-keystringRequired

Value for the x-api-key header parameter.

Path parameters

codestringRequired

StoredCreditAccount identifier

Responses

200

StoredCreditAccount resource

application/jsonapplication/ld+json

403

Forbidden

application/ld+jsonapplication/problem+jsonapplication/json

404

Not found

application/ld+jsonapplication/problem+jsonapplication/json

get

/gift_cards/{code}/balances

HTTPcURLJavaScriptPython

GET /gift_cards/{code}/balances HTTP/1.1
Host: api.glu.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "balances": [
    {
      "id": 1,
      "createdAt": "2025-11-21T11:12:24.389Z",
      "updatedAt": "2025-11-21T11:12:24.389Z",
      "type": "Activation",
      "amount": 1,
      "location": {},
      "happenedAt": "2025-11-21T11:12:24.389Z",
      "expiresAt": null,
      "reversed": {
        "id": 1,
        "createdAt": "2025-11-21T11:12:24.389Z",
        "updatedAt": "2025-11-21T11:12:24.389Z",
        "type": "Activation",
        "amount": 1,
        "location": {},
        "happenedAt": "2025-11-21T11:12:24.389Z",
        "expiresAt": null,
        "reversed": "[Circular Reference]",
        "mewsPayment": {},
        "attachedMember": "https://example.com/",
        "storedCreditAccount": {
          "balances": "[Circular Reference]"
        }
      },
      "mewsPayment": {},
      "attachedMember": "https://example.com/",
      "storedCreditAccount": {
        "balances": "[Circular Reference]"
      }
    }
  ]
}

Redeem a gift card

post

Redeem a gift card by providing the amount and currency.

Authorizations

x_api_key

x-api-keystringRequired

Value for the x-api-key header parameter.

Path parameters

codestringRequired

StoredCreditAccount identifier

Body

application/jsonapplication/ld+json

objectOptional

Responses

201

StoredCreditAccount resource created

application/jsonapplication/ld+json

400

Invalid input

application/ld+jsonapplication/problem+jsonapplication/json

403

Forbidden

application/ld+jsonapplication/problem+jsonapplication/json

422

An error occurred

application/ld+jsonapplication/problem+jsonapplication/json

post

/gift_cards/{code}/redeem

HTTPcURLJavaScriptPython

POST /gift_cards/{code}/redeem HTTP/1.1
Host: api.glu.io
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

application/jsonapplication/ld+json

{}

Retrieve a stored credit account by its code

get

Retrieve a stored credit account by its unique code. The response includes details such as the balance, status, and validity period.

Authorizations

x_api_key

x-api-keystringRequired

Value for the x-api-key header parameter.

Path parameters

codestringRequired

StoredCreditAccount identifier

Responses

200

StoredCreditAccount resource

application/jsonapplication/ld+json

403

Forbidden

application/ld+jsonapplication/problem+jsonapplication/json

404

Not found

application/ld+jsonapplication/problem+jsonapplication/json

get

/stored_credit_accounts/{code}

HTTPcURLJavaScriptPython

GET /stored_credit_accounts/{code} HTTP/1.1
Host: api.glu.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "id": 1,
  "createdAt": "2025-11-21T11:12:24.389Z",
  "updatedAt": "2025-11-21T11:12:24.389Z",
  "contact": "https://example.com/",
  "giftCard": "https://example.com/",
  "balances": [
    "https://example.com/"
  ],
  "attachedMember": "https://example.com/",
  "type": "Gift Card",
  "currencyCode": "text"
}