Get customer credit balances by external ID

GET

https://api.agentpaid.io/api/v2/customers/external/:externalId/credits/balances

GET

/api/v2/customers/external/:externalId/credits/balances

1 import { PaidClient } from "@paid-ai/paid-node";
2 
3 async function main() {
4     const client = new PaidClient({
5         token: "YOUR_TOKEN_HERE",
6     });
7     await client.customers.getCustomerCreditBalancesByExternalId("externalId");
8 }
9 main();

1 {
2   "data": [
3     {
4       "creditsCurrencyId": "c123e456-789b-12d3-a456-426614174000",
5       "currencyName": "US Dollar",
6       "currencyKey": "USD",
7       "available": 1500.75,
8       "used": 500.25,
9       "total": 2001,
10       "periodStart": "2024-04-01T00:00:00Z",
11       "periodEnd": "2024-04-30T23:59:59Z",
12       "rolloverEndDate": "2024-05-15T23:59:59Z",
13       "recipient": "organization"
14     },
15     {
16       "creditsCurrencyId": "d234f567-89ac-23d4-b567-526715274001",
17       "currencyName": "Euro",
18       "currencyKey": "EUR",
19       "available": 800,
20       "used": 200,
21       "total": 1000,
22       "periodStart": "2024-04-01T00:00:00Z",
23       "periodEnd": "2024-04-30T23:59:59Z",
24       "rolloverEndDate": "2024-05-15T23:59:59Z",
25       "recipient": "seat"
26     }
27   ]
28 }

Get current customer credit balances grouped by currency, looked up by external ID

Authentication

AuthorizationBearer

API Key authentication using Bearer token

Path parameters

externalIdstringRequired

Response

200

datalist of objects

Errors

403

Forbidden Error

404

Not Found Error

500

Internal Server Error