v1

latestOpenAPI 3.0.02026-07-24231140.6 KB

Products

Search products by query.

get/products/search

Query parameters

qstring required

Search query string (1-100 characters)

startinteger

Start index. (Default: 0)

limitinteger

Maximum amount of returned records (Maximum/Default: 50)

include_test_productsboolean

If the search should include test products (Default: false)

Response

Success

Example response

{
  "meta": {
    "q": "gift card",
    "limit": 50,
    "total_results": 125,
    "_endpoint": "/products/search",
    "_next": "https://api.bitrefill.com/v2/products/search?q=gift%20card&limit=50&start=50"
  },
  "data": [
    {
      "id": "test-gift-card-link",
      "name": "Test Gift Card Link",
      "country_code": "KN",
      "country_name": "St Kitts and Nevis",
      "currency": "USD",
      "created_time": "2021-10-04T17:02:22.768Z",
      "recipient_type": "none",
      "image": "https://res.cloudinary.com/bitrefill/d_operator.png/this_is_a_test",
      "in_stock": true,
      "packages": {
        "id": "test-gift-card-link<&>10",
        "price": 12
      },
      "range": {
        "min": 10,
        "max": 100,
        "step": 10,
        "price_rate": 1.2
      }
    }
  ]
}