Skip to main content
GET
/
v2
/
gift-card-orders
List gift card orders
curl --request GET \
  --url https://api.gameboost.com/v2/gift-card-orders \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 123,
      "gift_card_id": 123,
      "gift_card_offer_id": 123,
      "region_id": 123,
      "brand_id": 123,
      "buyer": {
        "id": 123,
        "username": "<string>"
      },
      "title": "<string>",
      "face_value_amount": "<string>",
      "face_value_unit": "<string>",
      "quantity": 123,
      "unit_price_eur": "<string>",
      "unit_price_usd": "<string>",
      "price_eur": "<string>",
      "price_usd": "<string>",
      "status": "pending",
      "keys": [
        {
          "id": 123,
          "gift_card_order_id": 123,
          "key": "<string>",
          "type": {
            "value": "text",
            "name": "<string>"
          },
          "created_at": 123,
          "revealed_at": 123
        }
      ],
      "created_at": 123,
      "updated_at": 123,
      "completed_at": 123,
      "refunded_at": 123
    }
  ],
  "meta": {
    "current_page": 123,
    "from": 123,
    "last_page": 123,
    "per_page": 123,
    "to": 123,
    "total": 123
  },
  "links": {
    "first": "<string>",
    "last": "<string>",
    "prev": "<string>",
    "next": "<string>"
  }
}

Authorizations

Authorization
string
header
required

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

Query Parameters

Search gift card orders by id

filter[gift_card_id]
string

Filter by exact gift card id. Supports comma-separated values for multiple matches.

Example:

374097

filter[gift_card_offer_id]
string

Filter by exact gift card offer id. Supports comma-separated values for multiple matches.

Example:

953282

filter[region_id]
string

Filter by exact region id. Supports comma-separated values for multiple matches.

Example:

735836

filter[brand_id]
string

Filter by exact brand id. Supports comma-separated values for multiple matches.

Example:

231504

filter[buyer_id]
string

Filter by exact buyer id. Supports comma-separated values for multiple matches.

Example:

124956

filter[status]
enum<string>

Filter by order status

Available options:
pending,
in_delivery,
delivered,
refunded
Example:

"pending"

filter[created_at]
string

Filter by created at. Supports single date (YYYY-MM-DD) or date range (YYYY-MM-DD,YYYY-MM-DD).

Example:

"2019-08-14,2025-12-31"

filter[updated_at]
string

Filter by updated at. Supports single date (YYYY-MM-DD) or date range (YYYY-MM-DD,YYYY-MM-DD).

Example:

"2025-10-05"

filter[completed_at]
string

Filter by completed at. Supports single date (YYYY-MM-DD) or date range (YYYY-MM-DD,YYYY-MM-DD).

Example:

"2019-08-14,2025-12-31"

filter[refunded_at]
string

Filter by refunded at. Supports single date (YYYY-MM-DD) or date range (YYYY-MM-DD,YYYY-MM-DD).

Example:

"2019-08-14,2025-12-31"

sort
enum<string>
default:-created_at

Sort by field. Prefix with - for descending order.

Available options:
id,
-id,
unit_price,
-unit_price,
price,
-price,
quantity,
-quantity,
created_at,
-created_at,
updated_at,
-updated_at,
completed_at,
-completed_at
Example:

"-created_at"

per_page
integer
default:15

Items per page (max 50)

Required range: 1 <= x <= 50

Response

A paginated list of gift card orders

data
object[]
meta
object