---
title: "Search products by query."
method: GET
path: "/products/search"
tags: ["Products"]
---

# Search products by query.

`GET /products/search`

## Query parameters

- `q` string, required
- `start` integer
- `limit` integer
- `include_test_products` boolean

## Response `200`

Success

- object
  - `meta` object
    - `q` string
    - `start` integer
    - `limit` integer
    - `include_test_products` boolean
    - `total_results` integer — Total number of products matching the search query
    - `_endpoint` string
    - `_next` string — URL for the next page of results (if available)
  - `data` Product[]
    - `id` string
    - `name` string
    - `country_code` string
    - `country_name` string
    - `currency` string
    - `created_time` string
    - `recipient_type` string
    - `image` string
    - `in_stock` boolean
    - `packages` object
      - `id` string
      - `value` string
      - `price` number — Price of the package in the user's currency.
    - `range` object
      - `min` number
      - `max` number
      - `step` number
      - `price_rate` number — Price rate between the product currency and the user's currency.

## Other responses

- `400` — Bad request - missing or invalid search query
- `429` — Too many requests - product quota exceeded
- `503` — Service unavailable - search service temporarily unavailable

---

[API](https://skmtc.dev/bitrefill/apis/bitrefill-api-documentation.md) · [All operations](https://skmtc.dev/bitrefill/apis/bitrefill-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bitrefill/bitrefill-api-documentation/revisions/09e1bde6bae5/schema)