Fetch Gift Cards

Before creating a buy transaction, use this endpoint to fetch available gift cards.

This endpoint returns a paginated list of gift cards that are currently available for purchase through the Prestmit Partners API. Only cards with an active status are returned; inactive or delisted cards are automatically excluded.

You can optionally filter results by currency (e.g. only USD-denominated cards).

The response follows a standard paginated format, with each gift card object containing two product identifiers: sku and upc, along with pricing range, currency details, description, categories, supported regions, and image URL. Use sku to reference a specific gift card when placing a buy order. Treat upc as a secondary catalog identifier for inventory and reference purposes.

Authentication

Send your Partner API key in the API-KEY header on every request.

Get your Partner API key.
Add to the header: API-KEY: YOUR_API_KEY.
Add to the header: Accept: application/json.

📡 Endpoint

GET /giftcard-trade/buy/fetch-buyable-giftcards

This endpoint returns a paginated list of gift cards that are currently available for purchase.

🧾 Query Parameters

Parameter	Type	Required	Description
`currencyCode`	String	No	Filter gift cards by currency code. Must be exactly 3 characters (ISO 4217 format, e.g. `USD`, `EUR`, `GBP`). When provided, only gift cards denominated in that currency are returned.
`page`	Number	No	The page number for pagination. Minimum value is `1`. Defaults to `1`.
`perPage`	Number	No	Number of gift cards per page. Minimum `1`, maximum `25`. Defaults to `10`.

Example Request

A sample cURL request showing how to call the endpoint with the required headers. Replace YOUR_API_KEY with your actual partner API key.

curl -X GET "https://api.prestmit.io/partners/v1/giftcard-trade/buy/fetch-buyable-giftcards" \
  -H "Accept: application/json" \
  -H "API-KEY: YOUR_API_KEY"

Giftcard Response Object

A breakdown of all the keys returned in each gift card object within the data array of the paginated response.

Parameter	Type	Description
`sku`	Number	The Stock Keeping Unit identifier for the gift card product. This is the unique product ID used to reference this gift card when placing a buy order.
`upc`	Number	The Universal Product Code for the gift card. A secondary numeric identifier for the product, typically used for catalog/inventory purposes.
`title`	String	The display name of the gift card (e.g. "iTunes $50", "Amazon Gift Card").
`description`	Object	A nested object containing descriptive text about the gift card. Has two sub-keys: `title` (a short heading/summary of the card) and `content` (the full description body with usage details, terms, or redemption instructions). Either may be `null` if no description is available.
`minPrice`	Number	The minimum denomination/face value available for this gift card, in the card's native currency.
`maxPrice`	Number	The maximum denomination/face value available for this gift card, in the card's native currency. If `minPrice` equals `maxPrice`, the card is a fixed-denomination product.
`currency`	Object	A nested object describing the currency the gift card is denominated in. Contains: `currency` (the full currency name, e.g. "US Dollar"), `symbol` (the currency symbol, e.g. "$"), and `code` (the ISO 4217 currency code, e.g. "USD").
`preOrder`	Boolean	Indicates whether this gift card is available for pre-order. When `true`, the card may not be immediately fulfilled and delivery could be delayed.
`categories`	Array	An array of category objects that this gift card belongs to. Each category object contains a single `name` key (e.g. "Gaming", "Entertainment", "Shopping").
`regions`	Array	An array of region objects indicating where this gift card can be redeemed. Each region object contains `name` (the region's display name, e.g. "United States") and `code` (the region's short code, e.g. "US").
`imageUrl`	String	The URL to the gift card's product image.

Sample Response

A full JSON response showing the structure, data types, and example values for each key in the gift card object. This sample shows populated description fields for clarity, but description.title and description.content can still be null in live responses when no description is available.

{
    "data": [
        {
            "sku": 4611,
            "upc": 122,
            "title": "Amazon Gift Card",
            "description": {
                "title": "Gift card details",
                "content": "Description content for this gift card product."
            },
            "minPrice": 10,
            "maxPrice": 1000,
            "currency": {
                "currency": "US Dollar",
                "symbol": "$",
                "code": "USD"
            },
            "preOrder": true,
            "categories": [
                {
                    "name": "Shopping"
                }
            ],
            "regions": [
                {
                    "name": "United States",
                    "code": "US"
                }
            ],
            "imageUrl": "image-url"
        },
        {
            "sku": 4613,
            "upc": 1222,
            "title": "iTunes $50",
            "description": {
                "title": "Gift card details",
                "content": "Description content for this gift card product."
            },
            "minPrice": 10,
            "maxPrice": 1000,
            "currency": {
                "currency": "US Dollar",
                "symbol": "$",
                "code": "USD"
            },
            "preOrder": true,
            "categories": [
                {
                    "name": "Entertainment"
                }
            ],
            "regions": [
                {
                    "name": "United States",
                    "code": "US"
                }
            ],
            "imageUrl": "image-url"
        }
    ],
    "links": {
        "first": "https://prestmit.com/api/partners/v1/giftcard-trade/buy/fetch-buyable-giftcards?perPage=10&page=1",
        "last": "https://prestmit.com/api/partners/v1/giftcard-trade/buy/fetch-buyable-giftcards?perPage=10&page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "https://prestmit.com/api/partners/v1/giftcard-trade/buy/fetch-buyable-giftcards?perPage=10&page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "path": "https://prestmit.com/api/partners/v1/giftcard-trade/buy/fetch-buyable-giftcards",
        "per_page": 10,
        "to": 5,
        "total": 5
    }
}