Read an account
curl --request GET \
--url https://examples.staging.rampapay.com/v1/accounts/{id} \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://examples.staging.rampapay.com/v1/accounts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://examples.staging.rampapay.com/v1/accounts/{id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "acc_7Hq2Lx9TbR4mW1cZ8kP3sN6v",
"type": "crypto",
"balances": [
{
"currency": "USDT",
"available": "897.960000",
"reserved": "0.000000"
}
],
"funding_instructions": [
{
"network": "tron:0x2b6653dc",
"address": "TWd4WrZ9wn84f5x1hZhL4DHvk738ns5jwb",
"supported_assets": [
{
"currency": "USDT",
"decimals": 6,
"caip19": "tron:0x2b6653dc/trc20:TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
}
]
}
],
"as_of": "2026-09-27T14:06:40.000Z"
}Accounts
Read an account
One account by its acc_ id, as GET /accounts lists it.
GET
/
accounts
/
{id}
Read an account
curl --request GET \
--url https://examples.staging.rampapay.com/v1/accounts/{id} \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://examples.staging.rampapay.com/v1/accounts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://examples.staging.rampapay.com/v1/accounts/{id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "acc_7Hq2Lx9TbR4mW1cZ8kP3sN6v",
"type": "crypto",
"balances": [
{
"currency": "USDT",
"available": "897.960000",
"reserved": "0.000000"
}
],
"funding_instructions": [
{
"network": "tron:0x2b6653dc",
"address": "TWd4WrZ9wn84f5x1hZhL4DHvk738ns5jwb",
"supported_assets": [
{
"currency": "USDT",
"decimals": 6,
"caip19": "tron:0x2b6653dc/trc20:TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
}
]
}
],
"as_of": "2026-09-27T14:06:40.000Z"
}Try it: enter any key that starts with
rpk_mock_, e.g. rpk_mock_yourname. It answers from the example server with sample data — nothing real moves. Never enter your real key.Errors
| HTTP | Code | What to do |
|---|---|---|
| 400 Bad Request | INVALID_ | Not an account id (acc_ followed by 24 letters and digits). |
| 404 Not Found | ACCOUNT_ | No account with that id for your key. |
401 AUTHENTICATION_FAILED, 403 SCOPE_REQUIRED and the 503s in Errors.