GET /merchants/{merchantId} — Retrieve a Merchant by ID

GET /merchants/{merchantId} returns the full profile of a single merchant sub-account linked to your company. You can identify the merchant using any of three values — businessAccountCode, externalMerchantId, or MongoDB _id — whichever is most convenient for your system.

Requirements

Account type: Company account only.
Scope: merchants

Authentication

Header	Value
`Authorization`	`Bearer nsk_live_YOUR_KEY`

Path parameter

string

required

The merchant identifier. Accepts any of the following:

Value	Example
`businessAccountCode`	`48291736`
`externalMerchantId`	`shop_123`
MongoDB `_id`	`66f1a2b3c4d5e6f7a8b9c0d1`

The API resolves all three formats automatically — you do not need to specify which type you are sending.

Request

Fetch by externalMerchantId

curl "https://now.com.eg/api/public/v1/merchants/shop_123" \
  -H "Authorization: Bearer nsk_live_YOUR_KEY"

Fetch by businessAccountCode

curl "https://now.com.eg/api/public/v1/merchants/48291736" \
  -H "Authorization: Bearer nsk_live_YOUR_KEY"

Response

200 — Success

{
  "success": true,
  "data": {
    "merchant": {
      "id": "66f1a2b3c4d5e6f7a8b9c0d1",
      "businessAccountCode": "48291736",
      "name": "Acme Store",
      "brandName": "Acme",
      "email": "owner@acme.com",
      "phoneNumber": "01000000000",
      "externalMerchantId": "shop_123",
      "isCompleted": true,
      "isVerified": true,
      "parentCompany": "66e0a1b2c3d4e5f6a7b8c9d0",
      "createdAt": "2026-07-26T15:00:00.000Z"
    }
  }
}

string

MongoDB _id of the merchant account.

string

8-digit code assigned by Now Shipping. Use this as X-Merchant-Id on order and pickup requests.

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, as provided at onboarding.

boolean

true when the merchant profile is fully complete.

boolean

true when the account is verified and ready to create shipments.

string

MongoDB _id of the company account that owns this merchant sub-account.

string

ISO 8601 timestamp of when the account was created.

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.
`404`	`NOT_FOUND`	No merchant with the given `merchantId` exists under your company account.

A 404 means either the ID doesn’t exist or the merchant belongs to a different company. Use GET /merchants with a search query to browse your linked accounts, or call POST /merchants to onboard the merchant if they haven’t been created yet.

System

Merchants

Fees

Orders

Pickups

Reference

GET /merchants/{merchantId} — Retrieve a Merchant by ID

Requirements

Authentication

Path parameter

Request

Fetch by externalMerchantId

Fetch by businessAccountCode

Response

200 — Success

Errors

​Requirements

​Authentication

​Path parameter

​Request

​Fetch by externalMerchantId

​Fetch by businessAccountCode

​Response

​200 — Success

​Errors

Requirements

Authentication

Path parameter

Request

Fetch by externalMerchantId

Fetch by businessAccountCode

Response

200 — Success

Errors