---
title: "List the business's gift cards, newest first, each with its code, who it's for and from, and what's left on it (balance). Page with before=<next_before>."
method: GET
path: "/gift_cards"
tags: ["gift_cards"]
---

# List the business's gift cards, newest first, each with its code, who it's for and from, and what's left on it (balance). Page with before=<next_before>.

`GET /gift_cards`

## Request

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

## Query parameters

- `limit` integer
- `before` string, uuid: A card's id: the page continues with those made before it (pass next_before)

## Response `200`

Success

- object
  - `data` object[], required
    - `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)
  - `next_before` string, nullable, required: Pass as before= for the next page; null after the last

## 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)