Common
Balance
Institution
Payment
OTC
Convert
Payout
Gift Card
Subscription
curl --request GET \
--url https://openplatform.gateapi.io/merchant/open/institution/v1/accounts/list \
--header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
--header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
--header 'X-GatePay-Signature: <x-gatepay-signature>' \
--header 'X-GatePay-Timestamp: <x-gatepay-timestamp>'{
"status": "SUCCESS",
"code": "000000",
"errorMessage": "",
"data": {
"accounts": [
{
"request_id": "35778162074976257",
"account_id": "2124543768",
"customer_id": "1234",
"display_name": "my test",
"status": "ACTIVE",
"created": 1764139266551
}
],
"has_more": false
}
}List Sub-accounts
Paginated list of sub-accounts.
curl --request GET \
--url https://openplatform.gateapi.io/merchant/open/institution/v1/accounts/list \
--header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
--header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
--header 'X-GatePay-Signature: <x-gatepay-signature>' \
--header 'X-GatePay-Timestamp: <x-gatepay-timestamp>'{
"status": "SUCCESS",
"code": "000000",
"errorMessage": "",
"data": {
"accounts": [
{
"request_id": "35778162074976257",
"account_id": "2124543768",
"customer_id": "1234",
"display_name": "my test",
"status": "ACTIVE",
"created": 1764139266551
}
],
"has_more": false
}
}Documentation Index
Fetch the complete documentation index at: https://docs.gate.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
This page documents theGET /merchant/open/institution/v1/accounts/list endpoint. The full schema, parameters, and examples are rendered from the linked OpenAPI definition above.
Notes
- Authentication uses the standard GatePay signed headers.
- This dedicated institution endpoint does not use
X-GatePay-On-Behalf-Of. - For shared signing rules, see /api-reference/version/100/en/common/securityAndSignature.
Headers
The clientId assigned when the merchant registers an application in the Gate merchant console.
"4186d0c6-6a35-55a9-8dc6-5312769dbff8"
UTC timestamp in milliseconds when the request is generated. GatePay will not process requests where the difference from the receive time exceeds 10 seconds.
"1672905655498"
Random string. Must comply with HTTP header rules; recommended length is within 32 characters, composed of digits and letters.
"9578"
Request signature. GatePay uses this signature to verify whether the request is valid.
Query Parameters
Status: created - ACTIVE.
ACTIVE Creation request ID.
"35778162074976257"
Customer ID on the platform side.
Creation time (ms) ≥.
Creation time (ms) ≤.
Page size, default 20, max 200.
x <= 20020
Cursor (page number), starting from 1.
1