---
title: "Find gift card by id"
method: GET
path: "/gift_cards/by_id/{id}"
tags: ["Gift Cards"]
---

# Find gift card by id

`GET /gift_cards/by_id/{id}`

Finds and returns the gift card with the given id. Returns a 404 if the card does not exist.

Within the gift card structure returned is the field `gift_card_transactions` which contains a list of all the transactions associated with the gift card. In this list you will see one or more of the following statuses:

* "ACTIVATION" - This transaction type is added automatically when the gift card is created. The amount will be the initial balance that was loaded onto the gift card.
* "REDEEMING" - This status indicates the customer used their gift card to pay for one or more items. The amount MUST be negative.
* "IMPORTING" - You should only see this if gift cards were imported into the gift card system.
* "VOIDING" - You will see this status if the gift card has been voided. Note that the balance of the card is set to zero when the gift card is voided.
* "EXPIRING" - This transaction is added automatically when the gift card expires. Again note that the balance is set to zero when the gift card expires.
* "REVERSING" - This status indicates that a given transaction was reversed.
* "RELOADING" - This status means that more credit was loaded onto the gift card.

🔒 Requires: `gift_cards:read` scope

## Path parameters

- `id` string, required

## Response `200`

Gift card successfully retrieved.

- GiftCardSingleton — A single gift card response.
  - `data` GiftCard, required — A gift card with monetary values represented as strings for precision.
    - `balance` string — The balance of the gift card, represented as a string for precision.
    - `created_at` string — The creation timestamp in UTC.
    - `expires_at` string, nullable — The expiry timestamp in UTC.
    - `gift_card_transactions` GiftCardTransaction[] — An array of Gift Card Transactions.
      - `amount` string — The transaction amount, represented as a string for precision.
      - `client_id` string, nullable — The client id is a unique transaction identifier. The client must provide this and is normally the transaction id from the client system.
      - `created_at` string — The creation timestamp in UTC.
      - `id` string — Auto-generated object ID.
      - `source` string, nullable — The source of the transaction.
      - `source_id` string, nullable — The source id is a unique identifier for the transaction in the source system.
      - `type` 'ACTIVATION' | 'REDEEMING' | 'IMPORTING' | 'VOIDING' | 'EXPIRING' | 'REVERSING' | 'RELOADING' — The type of transaction.
      - `user_id` string — The user id associated with the transaction.
    - `id` string — Auto-generated object ID.
    - `number` string — The gift card number.
    - `sale_id` string, nullable — The ID of the sale associated with the gift card creation, if it was created through a register sale. Null if the gift card was created directly via the API.
    - `sale_source` string — The source system where the gift card was created (e.g. x-series, e-series).
    - `status` 'ACTIVE' | 'INACTIVE' | 'REDEEMED' | 'VOIDED' | 'EXPIRED' — The gift card status.
    - `total_redeemed` string — The amount redeemed with this gift card, represented as a string for precision.
    - `total_sold` string — The amount loaded onto this gift card during activation or reloading, represented as a string for precision.

## Other responses

- `404` — Gift card was not found.

---

[API](https://skmtc.net/lightspeedhq/apis/api-2026-07.md) · [All operations](https://skmtc.net/lightspeedhq/apis/api-2026-07/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightspeedhq/api-2026-07/revisions/72d4ceb46dbb/schema)