Retrieves a list of gift cards. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints.

https://shopify.com/admin/api/2020-01/gift_cards.json

https://shopify.dev/docs/admin-api/rest/reference/plus/giftcard#index-2020-01

Access Token Required: API Key

Query Params

statusstring

Retrieve gift cards with a given status. Valid values: enabled: Restrict results to only enabled gift cards disabled: Restrict results to only disabled gift cards

limitstring

The maximum number of results to show. (default: 50, maximum: 250)

since_idstring

Restrict results to after the specified ID.

fieldsstring

Show only certain fields, specified by a comma-separated list of field names.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'https://shopify.com/admin/api/2020-01/gift_cards.json' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

GET