Skip to main content
GET
/
v1
/
merchants
/
{id}
Get Merchant
curl --request GET \
  --url https://olp-api.nipuntheekshana.com/v1/merchants/{id}
This endpoint requires a valid Bearer token in the Authorization header. Merchants can only access their own profile unless they have admin privileges.

Path Parameters

id
string
required
The unique merchant identifier (e.g., merch_abc123).

Example Response (200)

{
  "id": "merch_abc123",
  "businessName": "Acme Payments Ltd",
  "email": "admin@acmepay.com",
  "phone": "+94771234567",
  "businessType": "company",
  "status": "active",
  "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
  "webhookUrl": "https://acmepay.com/webhooks/openpay",
  "twoFactorEnabled": true,
  "kycStatus": "verified",
  "createdAt": "2026-03-26T10:00:00Z",
  "updatedAt": "2026-03-26T12:30:00Z"
}

Error Responses

404 Not Found
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Merchant not found"
  }
}
403 Forbidden
{
  "error": {
    "code": "FORBIDDEN",
    "message": "You do not have permission to view this merchant"
  }
}