---
title: "Get one gift card by its id or its code (in any case, spaced or not), with every change to what's on it: purchase or issue, redeems, refunds and adjusts"
method: GET
path: "/gift_cards/{id}"
tags: ["gift_cards"]
---

# Get one gift card by its id or its code (in any case, spaced or not), with every change to what's on it: purchase or issue, redeems, refunds and adjusts

`GET /gift_cards/{id}`

## Request

- Base URL: `https://daybag.io/api/v1`
- URL: `https://daybag.io/api/v1/gift_cards/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required: The card's id, or its code

## Response `200`

Success

- object
  - `id` string, required
  - `org_id` string, required
  - `code` string, required: 12 characters of Crockford base32, as made: guests give it as they book (bookings.create's gift_card_code), in any case, spaced or not
  - `amount_cents` integer, required: What it was worth when made, in the currency's minor units (cents; whole yen for zero-decimal currencies)
  - `currency` string, required: ISO 4217, lowercase: the org's when it was made
  - `for_name` string, required: Who it's for, as given; may be empty
  - `for_email` string, required: Who it's for: emailed the code when it was made
  - `from_name` string, required: Who it's from: the buyer, or your business for one you issued
  - `from_email` string, required
  - `message` string, required: The buyer's message to who it's for, up to 300 characters; may be empty
  - `issued_by` 'purchase' | 'business', nullable, required: purchase: bought on your booking page; business: issued by you (gift_cards_issue)
  - `checkout_session_id` string, nullable, required: A bought card's Stripe Checkout, on your account
  - `payment_intent_id` string, nullable, required: A bought card's Stripe payment, on your account
  - `created_at` string, required: ISO 8601 timestamp (UTC)
  - `balance` integer, required: What's on it: the sum of its entries, in the currency's minor units (cents; whole yen for zero-decimal currencies). Gift cards never expire
  - `available` integer, required: What it can spend now: the balance less the parts of live holds that take it once they're confirmed, in the currency's minor units (cents; whole yen for zero-decimal currencies)
  - `entries` object[], required: Every change to what's on it, oldest first
    - `id` string, required
    - `booking_id` string, nullable, required: The booking a redeem or a refund was for
    - `cents` integer, required: Signed, in the currency's minor units (cents; whole yen for zero-decimal currencies): a purchase, an issue and a refund add, a redeem takes off, an adjust either
    - `kind` 'purchase' | 'issue' | 'redeem' | 'refund' | 'adjust', required: redeem: a booking was confirmed with it; refund: that booking was cancelled; adjust: you fixed the balance
    - `note` string, required: An adjust's reason
    - `created_at` string, required: ISO 8601 timestamp (UTC)

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/daybag/apis/daybooked-io-api.md) · [All operations](https://skmtc.dev/daybag/apis/daybooked-io-api/llms.txt) · [OpenAPI document](https://skmtc.dev/daybag/apis/daybooked-io-api/revisions/1f576dead370?raw)