Get Balance

Returns your current Payid19 balance in USDT: the amount available for withdrawal and the amount still in the holding period. Useful for dashboards, accounting jobs, or checking funds before an automated payout.

POSThttps://payid19.com/api/v1/get_balance

Request parameters

public_keystringREQUIRED

Your public API key.

private_keystringREQUIRED

Your private API key.

Response

statusstring

success or error.

balancenumeric

Your withdrawable balance in USDT — the amount you can send out right now with create_withdraw.

blocked_balancenumeric

Newly received payments still in the holding period, in USDT. They move to your withdrawable balance automatically — no action needed on your side.

messagestring

Empty on success; the error message when status is error.

{"status":"success","message":"","balance":1250.75,"blocked_balance":89.5}

Your total funds are balance + blocked_balance. The short holding period on fresh payments is a security measure; once it passes, the funds appear in balance automatically.

Example request

curl -X POST https://payid19.com/api/v1/get_balance \
  -d public_key=YOUR_PUBLIC_KEY \
  -d private_key=YOUR_PRIVATE_KEY

<?php
$post = [
    'public_key'  => 'YOUR_PUBLIC_KEY',
    'private_key' => 'YOUR_PRIVATE_KEY',
];

$ch = curl_init('https://payid19.com/api/v1/get_balance');
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($post));
$result = curl_exec($ch);
curl_close($ch);

$response = json_decode($result);
if ($response->status == 'error') {
    // message can be an array (key/validation errors) or a string
    echo is_array($response->message) ? $response->message[0] : $response->message;
} else {
    echo 'Available: ' . $response->balance . ' USDT' . PHP_EOL;
    echo 'Blocked: '   . $response->blocked_balance . ' USDT' . PHP_EOL;
}

const axios = require('axios');

axios.post('https://payid19.com/api/v1/get_balance', {
    public_key:  'YOUR_PUBLIC_KEY',
    private_key: 'YOUR_PRIVATE_KEY',
})
.then(({ data }) => {
    if (data.status === 'error') return console.error([].concat(data.message)[0]);
    console.log('Available:', data.balance, 'USDT');
    console.log('Blocked:',   data.blocked_balance, 'USDT');
})
.catch(err => console.error(err.message));

import requests

response = requests.post('https://payid19.com/api/v1/get_balance', data={
    'public_key':  'YOUR_PUBLIC_KEY',
    'private_key': 'YOUR_PRIVATE_KEY',
})

result = response.json()
if result['status'] == 'error':
    msg = result['message']
    print(msg[0] if isinstance(msg, list) else msg)
else:
    print('Available:', result['balance'], 'USDT')
    print('Blocked:',   result['blocked_balance'], 'USDT')