v1

latestOpenAPI 3.1.0MIT2026-07-211097127.9 KB

List Sub-Accounts

Paginated list of sub-accounts.

get/merchant/open/institution/v1/accounts/list

Query parameters

status'ACTIVE'

Status: created - ACTIVE.

request_idstring
Example:35778162074976257

Creation request ID.

customer_idstring

Customer ID on the platform side.

created_gteinteger

Creation time (ms) ≥.

created_lteinteger

Creation time (ms) ≤.

limitinteger
Example:20

Page size, default 20, max 200.

cursorinteger
Example:1

Cursor (page number), starting from 1.

Headers

X-GatePay-Certificate-ClientIdstring required
Example:4186d0c6-6a35-55a9-8dc6-5312769dbff8

The clientId assigned when the merchant registers an application in the Gate merchant console.

X-GatePay-Timestampstring required
Example:1672905655498

UTC timestamp in milliseconds when the request is generated. GatePay will not process requests where the difference from the receive time exceeds 10 seconds.

X-GatePay-Noncestring required
Example:9578

Random string. Must comply with HTTP header rules; recommended length is within 32 characters, composed of digits and letters.

X-GatePay-Signaturestring required

Request signature. GatePay uses this signature to verify whether the request is valid.

Response

Success

statusstring
codestring
errorMessagestring