GET
/api/v2/loyalty/merchantsGet merchants with search, filtering, and pagination
Authentication
Send your API key in the x-api-key header on every request.
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| search (query) | string | No | Optional search term for merchant name |
| category (query) | string | No | Optional filter by merchant category |
| isActive (query) | boolean | No | Optional filter by active status |
| isPartner (query) | boolean | No | Optional filter by partner status |
| limit (query) | unknown | No | Maximum number of merchants to return |
| offset (query) | unknown | No | Number of merchants to skip |
Responses
200 — OK
| Field | Type | Required | Description |
|---|---|---|---|
| Merchants | array of MerchantResponse | No | |
| Pagination | PaginationResponse | No |
401 — Unauthorized
| Field | Type | Required | Description |
|---|---|---|---|
| Message | string | No | |
| Code | string | No | |
| Status | unknown | No | |
| ValidationErrors | object | No | |
| Details | string | No |
500 — Internal Server Error
| Field | Type | Required | Description |
|---|---|---|---|
| Message | string | No | |
| Code | string | No | |
| Status | unknown | No | |
| ValidationErrors | object | No | |
| Details | string | No |
Example request
curl -X GET "https://{base_url}/api/v2/loyalty/merchants" \
-H "x-api-key: YOUR_API_KEY"This page is generated from the live OpenAPI specification and always matches the current API.