---
title: "Search the gift card catalog"
method: GET
path: "/search-gift-cards"
---

# Search the gift card catalog

`GET /search-gift-cards`

## Request

- Base URL: `https://laso.finance`
- URL: `https://laso.finance/search-gift-cards`
- Auth: API key in header `Authorization`

Browse and search available gift cards. Returns a list of gift card products with pricing, denomination, and catalog information. Use the `laso_server_id` from the results to order a card via `GET /order-gift-card`.

Every response includes a `facets` object listing the valid values for the `category`, `currency`, and `country` filters. The facets are computed from the full catalog, so a single unfiltered request (no query parameters) is enough to discover everything you can filter on.

This is a free endpoint — no x402 payment required. Requires a Bearer token from `/auth`.

## Query parameters

- `q` string
- `country` string
- `currency` string
- `category` string

## Response `200`

List of matching gift card products

- object
  - `gift_cards` GiftCardProduct[]
    - `laso_server_id` string: Product identifier to use when ordering via GET /order-gift-card
    - `name` string: Gift card brand name
    - `description` string
    - `category` string, nullable: Catalog category for the gift card (e.g. "ecommerce", "travel").
    - `country` string, nullable: ISO 3166-1 alpha-2 country the gift card belongs to. Null for borderless products available in more than one country.
    - `currency` string, nullable: Currency code for the gift card
    - `min` number: Minimum order amount
    - `max` number: Maximum order amount
    - `increment` string: Step the order amount must be a multiple of, in the product's currency. Usually "1" (whole units only, so 160.7 is rejected before payment). "0" means the product is only sold at the values in denominations.
    - `denominations` string[], nullable: If set, only these exact amounts can be ordered. Null for range-based products.
    - `product_image_url` string: URL of the gift card image
    - `catalog_info` object, nullable
      - `brand_description` string, nullable
      - `redemption_instructions` string, nullable
  - `count` integer: Number of results returned
  - `filters` object
    - `query` string, nullable
    - `country` string, nullable
    - `currency` string, nullable
    - `category` string, nullable
  - `facets` object: Valid filter values, computed from the full catalog. Use these to discover what you can pass to the `category`, `currency`, and `country` query parameters.
    - `categories` string[]: All valid `category` filter values.
    - `currencies` string[]: All valid `currency` filter values.
    - `countries` string[]: All valid `country` filter values (ISO 3166-1 alpha-2 codes).

## Other responses

- `401`: Missing or invalid Bearer token

---

[API](https://skmtc.dev/laso/apis/laso-finance-x402-api.md) · [All operations](https://skmtc.dev/laso/apis/laso-finance-x402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/laso/apis/laso-finance-x402-api/revisions/ff8ce20b49ba?raw)