---
title: "Search Merchants"
method: GET
path: "/api/v1/merchant/search"
tags: ["Merchant Management"]
---

# Search Merchants

`GET /api/v1/merchant/search`

Search & Retrieve Merchants, ACCESS LEVEL: SUPER_ADMIN, PARTNER, MERCHANT

## Query parameters

- `pageProperties` SearchPageable, required
  - `pageNumber` integer
  - `sortDirection` 'ASC' | 'DESC'
  - `pageSize` integer
  - `sortBy` string
- `searchCriteria` MerchantSearchCriteria, required
  - `text` string
  - `userId` string, uuid
  - `cityId` integer
  - `countryCode` string
  - `businessCategoryId` string, uuid
  - `partnerId` string, uuid
  - `name` string
  - `nameAR` string
  - `emailAddress` string
  - `currencyCode` string
  - `registeredMobileNumber` string
  - `createdTimeTo` string, date
  - `createdTimeFrom` string, date
  - `active` boolean
  - `businessUnitIds` string[]

## Response `200`

OK

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/edfapay/apis/revamp.md) · [All operations](https://skmtc.net/edfapay/apis/revamp/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/edfapay/revamp/revisions/8104cc1c9e38/schema)