Partner API
  1. User Accounts with KYC
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Partner Operations
      • Get Balances
      • Get Transaction History
      • Retrieve Exchange Rate and Create a Lock
      • Create and Finalize an Exchange
      • Create Crypto Withdrawal
      • Create a SEPA Transfer
      • Get SEPA Transfer Details
    • User Accounts with KYC
      • Create User Account and Generate Balances
        POST
      • Add KYC File
        POST
      • Add POA File
        POST
      • Add User Verification
        POST
      • Update Existing User
        PATCH
      • Delete User
        DELETE
      • Suspend User
        PATCH
      • Unsuspend User
        PATCH
      • Get User Balances
        GET
      • Get User Transaction History
        GET
    • User Accounts without KYC
      • Create User Account and Generate Balances Without KYC
      • Update Existing User
      • Delete User
      • Suspend User
      • Unsuspend User
      • Get User Balances
      • Get User Transaction History
    • KYC by P100
      • Creating KYC Verification
      • Redirect to Verification
      • Get KYC Status
    • Currency Exchange
      • Retrieve Exchange Rate
      • Retrieve Exchange Rate and Create a Lock
      • Create and Finalize an Exchange
      • Retrieve Detailed Exchange Infromation
    • Crypto Deposits
      • Update Travel Rule
    • Crypto Withdrawals
      • Get Network Fee
      • Create Crypto Withdrawal
      • Get Crypto Withdrawal Details
    • Internal Transfers
      • Create a Transfer
      • Get Transfer Details
    • Virtual Cards
      • Create Virtual Card
      • Get All User Cards
      • Get Card Details
      • Update Card PIN
      • Block Card
      • Unblock Card
      • Get Card Limits
      • Update Card Limits
      • Delete Card
    • Custom Fiat Operations
      • SEPA Deposit & Withdrawal
  • Integration
    • SDKs & Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • User & KYC Webhooks
        • User Balance Generation
        • KYC File Added
        • POA Verification Status
        • KYC Verification Status
      • Transfers & Payments Webhooks
        • P2P Transfer Webhook
        • SEPA Transfer
        • SEPA Deposit
        • Crypto Withdrawal
        • Crypto Deposit
        • Exchange
        • Card Transaction
      • Card Webhooks
        • Card 3DS Code
        • Card Activation Code
  • Reference
    • Supported Countries
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. User Accounts with KYC

Get User Balances

Testing Env
https://partner-api-stage.p100.io
Testing Env
https://partner-api-stage.p100.io
GET
/v1/user/{externalUserId}/balances
Retrieves the current balances for all cryptocurrencies and fiat currencies for a specific user. This endpoint provides a comprehensive overview of the user's financial assets within the system.
The endpoint returns detailed information about all fiat and crypto balances assigned to the user, including:
Current available amount for each currency
Currency name and type (fiat or crypto)
Wallet address (for crypto)
Exchange rate to EUR
Status of each balance (e.g., ACTIVE, WAITING_TO_BE_ACTIVATED)
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://partner-api-stage.p100.io/v1/user//balances' \
--header 'x-api-key;'
Response Response Example
200 - Success
{
    "fiatBalances": [
        {
            "id": "32f1bde8-b657-4221-940a-2d73bc6d3b7d",
            "amount": "76.51",
            "name": "eur",
            "rate": 1,
            "iban": "LT413130019950000957",
            "status": "ACTIVE"
        }
    ],
    "cryptoBalances": [
        {
            "id": "12945229-16ad-4bc9-a756-3175464040c2",
            "amount": "6.03457325",
            "name": "pol",
            "wallet": "0x9538f2f50c0f31ed39384bd009b002e6a8828b78",
            "rate": 0.19094656,
            "networkConfig": {
                "polygon": {
                    "mainnet": false,
                    "name": "amoy",
                    "withdrawal": {
                        "feeWithdrawal": 0.001,
                        "minWithdrawal": 0.00005
                    },
                    "deposit": {
                        "minDeposit": 0
                    }
                }
            }
        },
        {
            "id": "44570191-e540-4e2c-8b11-1e0683e2378d",
            "amount": "0.03081738",
            "name": "eth",
            "wallet": "0x9538f2f50c0f31ed39384bd009b002e6a8828b78",
            "rate": 3308.6004075,
            "networkConfig": {
                "ethereum": {
                    "mainnet": false,
                    "name": "sepolia",
                    "withdrawal": {
                        "feeWithdrawal": 0.003,
                        "minWithdrawal": 0.0006
                    },
                    "deposit": {
                        "minDeposit": 0
                    }
                }
            }
        },
        {
            "id": "fcb36ff8-e1d8-416c-9edf-7df2f1300ee5",
            "amount": "0.97365396",
            "name": "ltc",
            "wallet": "MWuKZiDNyzJ8zFyP9DTyEevMyo2zXc3XoW",
            "rate": 95.22538992,
            "networkConfig": {
                "ltc": {
                    "mainnet": false,
                    "name": "test",
                    "withdrawal": {
                        "feeWithdrawal": 0.002,
                        "minWithdrawal": 0.001
                    },
                    "deposit": {
                        "minDeposit": 0
                    }
                }
            }
        },
        {
            "id": "f08723ed-a1d9-4be8-9b6f-6185eb007732",
            "amount": "0.00097829",
            "name": "btc",
            "wallet": "3MU2PysVY1yKPok1LRc5pCYxmXyNVV7whH",
            "rate": 102475.93641872,
            "networkConfig": {
                "btc": {
                    "mainnet": false,
                    "name": "test",
                    "withdrawal": {
                        "feeWithdrawal": 0.0003,
                        "minWithdrawal": 0.000001
                    },
                    "deposit": {
                        "minDeposit": 0
                    }
                }
            }
        },
        {
            "id": "e459d758-2e31-454d-9013-1834f6b6ae69",
            "amount": "99.773248",
            "name": "usdc",
            "wallet": "0x9538f2f50c0f31ed39384bd009b002e6a8828b78",
            "rate": 0.864933,
            "networkConfig": {
                "ethereum": {
                    "mainnet": false,
                    "name": "sepolia",
                    "withdrawal": {
                        "feeWithdrawal": 10,
                        "minWithdrawal": 1
                    },
                    "deposit": {
                        "minDeposit": 5
                    }
                },
                "polygon": {
                    "mainnet": false,
                    "name": "amoy",
                    "withdrawal": {
                        "feeWithdrawal": 0.5,
                        "minWithdrawal": 2
                    },
                    "deposit": {
                        "minDeposit": 0
                    }
                }
            }
        },
        {
            "id": "87a7c037-9bd5-491d-b69e-e71c8efc9c52",
            "amount": "398.33177493",
            "name": "doge",
            "wallet": "D7n7AbnNaicYojMvtJgphdcK1foMZrn9d3",
            "rate": 0.19318475,
            "networkConfig": {
                "doge": {
                    "mainnet": false,
                    "name": "test",
                    "withdrawal": {
                        "feeWithdrawal": 5,
                        "minWithdrawal": 0.01
                    },
                    "deposit": {
                        "minDeposit": 0
                    }
                }
            }
        }
    ]
}

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Path Params

Responses

🟢200Success
application/json
Body

🟠401Access Denied
🟠400P412: User not exist
🟠400P500: Unknown exception
🟠400P501: Service temporarily unavailable
Previous
Unsuspend User
Next
Get User Transaction History
Built with