List merchants

Merchants

Description

Retrieve a paginated list of your merchant businesses.
Returns 30 merchants per page, ordered by most recent first.

Authentication Required: User must be authenticated and have the 'merchant' feature flag.

Users can only see their own merchant businesses.

page integer query

Page number for pagination (defaults to page 1 for invalid values)

200 Successful response

application/json

statusstring

Example: success

dataarray

current_pageinteger

Example: 1

total_resultsinteger

Example: 10

total_pagesinteger

Example: 1

401 Authentication required

application/json

Example:

{
  "status": "error",
  "message": "Not authenticated or insufficient permissions"
}

403 Insufficient permissions - user must be merchant

application/json

Example:

{
  "status": "error",
  "message": "Feature merchant required"
}