Merchant

Get Merchant

Returns a single merchant by UUID. The caller must own the merchant. Cross-account reads are blocked. Soft-deleted merchants (deleted_at <= now) are treated as non-existent and return 404.

Authentication

X-API-KEYstring
API Key authentication via header

Request

This endpoint expects an object.
merchantIdstringRequired
UUID of the merchant to retrieve

Response

OK
contactEmailstring
Primary contact email
contactFirststring
Primary contact first name
contactLaststring
Primary contact last name
merchantIdstring
UUID of the merchant
merchantNamestring
Merchant business name
statusenum
Derived lifecycle status
referenceIdstring
The ID you use in your own system to identify this merchant.

Errors

400
Get Merchant Body Bad Request Error
401
Get Merchant Body Unauthorized Error
404
Get Merchant Body Not Found Error
422
Get Merchant Body Unprocessable Entity Error
500
Get Merchant Body Internal Server Error