Skip to main content
GET
/
search-gift-cards
Search the gift card catalog
curl --request GET \
  --url https://laso.finance/search-gift-cards \
  --header 'Authorization: Bearer <token>'
{
  "gift_cards": [
    {
      "laso_server_id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "category": "<string>",
      "country": "FR",
      "currency": "USD",
      "min": 123,
      "max": 123,
      "increment": "<string>",
      "denominations": [
        "<string>"
      ],
      "product_image_url": "<string>",
      "catalog_info": {
        "brand_description": "<string>",
        "redemption_instructions": "<string>"
      }
    }
  ],
  "count": 123,
  "filters": {
    "query": "<string>",
    "country": "<string>",
    "currency": "<string>",
    "category": "<string>"
  },
  "facets": {
    "categories": [
      "<string>"
    ],
    "currencies": [
      "<string>"
    ],
    "countries": [
      "<string>"
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://agents.laso.finance/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

ID token from /auth or /get-card

Query Parameters

q
string

Search query to filter gift cards by name (e.g. "Amazon", "Uber")

country
string

ISO 3166-1 alpha-2 country code to filter by (e.g. "US", "GB"). Returns gift cards available in that country, including borderless products that have no country restriction.

currency
string

Currency code to filter by (e.g. "USD", "EUR")

category
string

Category to filter by (e.g. "ecommerce", "travel", "gaming"). See the facets.categories array in any response for the full list of valid values.

Response

List of matching gift card products

gift_cards
object[]
count
integer

Number of results returned

filters
object
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.