Returns a gift card by its ID
JavaScript
import { createClient } from '@spree/sdk' const client = createClient({ baseUrl: 'https://your-store.com', publishableKey: '<api-key>', }) const giftCard = await client.customer.giftCards.get('gc_abc123', { bearerToken: '<token>', })
{ "id": "gc_UkLWZg9DAJ", "code": "569C3E82B692C7E7", "status": "active", "currency": "USD", "amount": "10.0", "amount_used": "0.0", "amount_authorized": "0.0", "amount_remaining": "10.0", "display_amount": "$10.00", "display_amount_used": "$0.00", "display_amount_remaining": "$10.00", "expires_at": null, "redeemed_at": null, "expired": false, "active": true, "created_at": "2026-03-28T11:44:37.997Z", "updated_at": "2026-03-28T11:44:37.997Z" }
Publishable API key for store access
JWT token for authenticated customers
Comma-separated list of fields to include (e.g., name,slug,price). id is always included.
gift card found
Was this page helpful?