Skip to main content
GET
/
api
/
v1
/
business
/
products
/
search
Search Products
curl --request GET \
  --url https://api-stage.ugift.me/api/v1/business/products/search \
  --header 'X-API-Key: <api-key>'
{
  "products": [
    {
      "_id": "65a1b2c3d4e5f678901234ab",
      "imageUrl": "https://cdn.ugift.me/products/amazon-uk-card.png",
      "merchant": "Amazon UK",
      "productCode": "AMAZON_UK_STD",
      "country": "GB",
      "currency": "GBP",
      "minPrice": 10,
      "maxPrice": 500,
      "denominations": [
        10,
        25,
        50,
        100,
        200
      ],
      "category": "Retail,Shopping",
      "description": "Amazon.co.uk e-gift card for online purchases.",
      "termsAndConditions": "Subject to Amazon.co.uk balance and fraud checks.",
      "redemption": {
        "channel": "online"
      }
    }
  ],
  "pagination": {
    "total": 42,
    "totalPages": 5,
    "currentPage": 1,
    "limit": 10
  }
}

Authorizations

​
X-API-Key
string
header
required

Your UGiftMe API key for authentication.

Format: Secure API key (e.g., <your-api-key>)

Required: All endpoints require this header

Example: X-API-Key: <your-api-key>

Query Parameters

​
page
integer
default:1
Required range: x >= 1
​
limit
integer
default:10
​
merchant
string
​
category
string[]

Filter by category. Repeat this query parameter for multiple values (same encoding as the live API).

​
useCase
string[]

Filter by use case. Repeat this query parameter for multiple values.

Response

Search results

​
products
object[]
required
​
pagination
object
required
Example:
{
  "total": 42,
  "totalPages": 5,
  "currentPage": 1,
  "limit": 10
}