GET
/
buyers
/
gift-cards
curl --request GET \
  --url https://api.{gr4vy_id}.gr4vy.app/buyers/gift-cards \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "type": "gift-card",
      "id": "e6cdf979-87e2-4796-8ff6-9784d5aed893",
      "merchant_account_id": "default",
      "bin": "412345",
      "sub_bin": "554",
      "last4": "1234",
      "expiration_date": "2013-07-16T19:23:00.000+00:00",
      "balance": 1299,
      "currency": "USD",
      "balance_error_code": "incorrect_currency",
      "balance_raw_error_code": "10363",
      "balance_raw_error_message": "This currency is not supported by the merchant."
    }
  ]
}

This endpoint requires the gift-cards.read or embed scope.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
buyer_id
string

Filters the results to only the items for which the buyer has an id that matches this value.

Example:

"8724fd24-5489-4a5d-90fd-0604df7d3b83"

​
buyer_external_identifier
string

Filters the results to only the items for which the buyer has an external_identifier that matches this value.

Example:

"user-12345"

Response

200
application/json

Returns a list of available gift cards for a buyer.

A list of gift cards in a short format including the latest balance.