GET /merchants — Paginated Merchant Sub-Account List

GET /merchants returns a paginated list of every merchant sub-account linked to your company. Use the search parameter to quickly look up a specific merchant by name, email, phone number, brand name, businessAccountCode, or externalMerchantId — handy for resolving a merchant before placing an order or checking onboarding status in bulk.

Requirements

Account type: Company account only.
Scope: merchants

Authentication

Header	Value
`Authorization`	`Bearer nsk_live_YOUR_KEY`

Query parameters

integer

Page number to return. Defaults to 1.

integer

Number of merchants per page. Defaults to 50.

string

Full-text search across name, email, phoneNumber, brandName, businessAccountCode, and externalMerchantId. Partial matches are supported.

Request

curl "https://now.com.eg/api/public/v1/merchants?page=1&limit=20&search=acme" \
  -H "Authorization: Bearer nsk_live_YOUR_KEY"

Response

200 — Success

{
  "success": true,
  "data": {
    "merchants": [
      {
        "id": "66f1a2b3c4d5e6f7a8b9c0d1",
        "businessAccountCode": "48291736",
        "name": "Acme Store",
        "brandName": "Acme",
        "email": "owner@acme.com",
        "phoneNumber": "01000000000",
        "externalMerchantId": "shop_123",
        "isCompleted": true,
        "isVerified": true,
        "createdAt": "2026-07-26T15:00:00.000Z"
      }
    ],
    "pagination": {
      "currentPage": 1,
      "totalPages": 1,
      "totalCount": 1,
      "hasNext": false,
      "hasPrev": false
    }
  }
}

array

Array of merchant objects for the current page.

Show merchant object fields

string

MongoDB _id of the merchant account.

string

8-digit code — the primary value to pass as X-Merchant-Id.

string

Merchant owner or business name.

string

Public-facing brand name.

string

Contact email address.

string

Contact phone number.

string

Your platform’s shop ID, if provided at onboarding.

boolean

true when the merchant profile is fully complete.

boolean

true when the account is verified and ready to ship.

string

ISO 8601 timestamp of when the account was created.

object

Pagination metadata for the current result set.

Show pagination fields

integer

The page number returned in this response.

integer

Total number of pages available.

integer

Total number of merchants matching the query.

boolean

true if there is a next page.

boolean

true if there is a previous page.

Errors

Status	Code	Cause
`401`	`UNAUTHORIZED`	API key is missing or invalid.
`403`	`FORBIDDEN`	Key does not belong to a company account, or `SCOPE_DENIED` if the `merchants` scope is missing.

Use search with your externalMerchantId to check whether a merchant was already onboarded before calling POST /merchants. This lets you implement idempotent onboarding without catching 409 errors.

System

Merchants

Fees

Orders

Pickups

Reference

GET /merchants — Paginated Merchant Sub-Account List

Requirements

Authentication

Query parameters

Request

Response

200 — Success

Errors

​Requirements

​Authentication

​Query parameters

​Request

​Response

​200 — Success

​Errors

Requirements

Authentication

Query parameters

Request

Response

200 — Success

Errors