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

# Find gift card by transaction id

`GET /gift_cards/transactions/{transaction_id}`

Finds and returns the gift card associated with the given transaction id. Returns a 404 if the gift card with the given transaction id was not found.

Supports an optional `system_id` query parameter to specify the source system (defaults to x-series, also supports e-series).

🔒 Requires: `gift_cards:read` scope

## Path parameters

- `transaction_id` string, required

## Query parameters

- `system_id` 'x-series' | 'e-series'

## Response `200`

The gift card with this transaction id was successfully found.

- 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` — The gift card associated with the transaction id 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)