List merchants belonging to an organization

get

https://api.pushpay.com/v1/organization/{organizationKey}/merchantlistings

You can find merchants that belong to a specific organization. You can further filter this list by using one or more parameters for:

country (Country, valid values are NZ, AU, CA or US currently).
name (Full or partial name)
handle (the full handle for a merchant)

Note: Unfiltered requests will return merchants of Status = Active and Visibility = Visible

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

organizationKey

string

required

The unique key of the organization - a case-sensitive series of characters

Query Params

name

string

One or more terms between spaces which will each be matched partially against the name of the merchant

handle

string

The unique text 'handle' assigned to the merchant

country

string

enum

The country the Merchant resides within

visibility

string

enum

Returns merchant listings based on the specified visibility filter: 'Visible' returns only visible listings, while 'Hidden' returns both visible and hidden listings

Allowed:

status

string

enum

Only include merchant listings matching the specified status - Active/Pending/Closed

Allowed:

page

int32

required

The page parameter (Note: page numbering starts at 0)

pageSize

int32

required

The page size parameter (Note: default page size is 25)

Responses

400

The server will not process the request due to a client error

401

Request failed because the client was not authorized to perform this action

404

Could not find resource

429

Request was throttled due to too many requests from this client or IP address

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/hal+json

200success