Get client configuration
Fetch your own client configuration: company info, your fee schedule, your authorized banks, and your custodial wallet/vault. This is a self-service endpoint — you may only read your own record. Requesting any other client’s UUID returns 403.
The response envelope is { success, data }, where data contains a nested client object, optional client_wallets and client_vault objects (either may be null if not yet provisioned), and a top-level authorizedBanks array.
client.pct_fee,client.fixed_fee,client.usd_usdc_fee— fee values as decimal strings (usd_usdc_feemay benull).authorizedBanks— the banks you may use for virtual accounts: any ofportage,slovak_savings_bank,austin_capital_trust,zenus(defaults to[]).client_wallets— your custodial wallet (address,network__id,explorer_url);client_vault— your wallet vault (vault_id,name).
Errors: 400 for a malformed UUID; 403 when the path UUID is not your own; 404 when the client record is not found.
Example response (200):
{
"success": true,
"data": {
"client": {
"id": 42,
"client_uuid": "550e8400-e29b-41d4-a716-446655440000",
"company_name": "Acme Payments Inc.",
"pct_fee": "0.0250",
"fixed_fee": "0.50",
"usd_usdc_fee": "0.00",
"logo_url": "https://cdn.example.com/logos/acme.png",
"created_ts": "2025-03-01T12:00:00.000Z",
"updated_ts": "2026-06-01T09:30:00.000Z"
},
"client_wallets": {
"client_uuid": "550e8400-e29b-41d4-a716-446655440000",
"object": "wallet",
"address": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
"explorer_url": "https://explorer.solana.com/address/9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
"name": "Acme Treasury Wallet",
"network__id": "solana"
},
"client_vault": {
"vault_id": "770e8400-e29b-41d4-a716-446655440111",
"object": "sub-organization",
"name": "Acme Sub-Org",
"type": "single"
},
"authorizedBanks": [
"portage",
"zenus"
]
}
}
Authorizations
Access token from POST /auth (the data.access_token value).
API key issued by Kira. Required on every request, including /auth.
Headers
"2026-04-14"
Path Parameters
Client UUID (your own client identifier).
Response
Success.