Get an organization's balance

How much DUAL the organization has left to spend on actions. Every action costs something, and it comes out of this balance. Top it up by sending DUAL on chain; payments appear in `GET /payments/deposits` and are added here once credited. Watch this figure and warn people before it runs out — an action fails when there is not enough left to pay for it. Requires the `organizations.read` permission.

GET
/organizations/{organizationId}/balance

Authorization

AuthorizationBearer <token>

The access token returned after a successful sign-in, sent as Authorization: Bearer <access_token>.

It identifies the person and the organization they are working in, and it lasts about fifteen minutes. When it runs out, use their refresh token at POST /auth/refresh-token instead of asking them to sign in again.

In: header

Path Parameters

organizationId*string

Identifier of the organization. Each endpoint states whether it must be the caller's active organization or may be used without authentication.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.dual.network/organizations/665f1c2d4b1a2c3d4e5f6aa0/balance"
{
  "amount": "1284.520000"
}
{
  "code": 3,
  "message": "Key: 'limit' Error:Field validation for 'limit' failed on the 'lte' tag"
}

{
  "code": 16,
  "message": "no auth provided"
}

{
  "code": 5,
  "message": "object not found"
}
{
  "code": 13,
  "message": "internal error"
}