Returns all the customers that you have access to


The Id returned is used in both the terminal update CreateUpdate and the merchant onboarding CreateRequest calls

Id VS Parent

Access is built on a tree structure where one customer can create ‘infinite’ sub-structures with branches for each sibling.

Idthe merchant customer number in Access
parentthe Id of the parent to the merchant (the creater of the merchant)

The Parent ID is used as part of the CreateRequest in the onboarding request to define where the user should be located in the tree structure.


  • Your id is 1 and you want to create a new merchant sibling. Then you defined “Parent” as 1 when creating the merchant.
  • The Merchant you just created got id 2, to create a new level then you defined “Parent” as 2 when creating a new merchant.
Click Try It! to start a request and see the response here!