> ## Documentation Index
> Fetch the complete documentation index at: https://docs-api.kravata.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get FIAT Balance Summary

> Returns the aggregated fiat balance of your client across all of its users.

#### Request

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| Authorization | Header | Yes | `Bearer <access_token>` obtained from **POST /api/v1/client/token**. |
| currency | Query | Yes | Fiat currency (e.g. `COP`). |

#### Response

An array with one entry per currency:

| Field | Description |
| --- | --- |
| currency | Fiat currency. |
| totalAvailable | Sum of the available balances. |
| totalPendingPayin | Sum of pay-ins not yet confirmed. |
| totalPendingPayout | Sum of payouts in progress. |
| userCount | Number of users with a balance. |



## OpenAPI

````yaml /stack/openapi.json get /api/v1/admin/fiats/balances/summary
openapi: 3.1.0
info:
  title: Kravata Stack API
  version: '2.0'
  description: >-
    Kravata Stack API: users, accounts, custody wallets, liquidity ramps and
    fiat payments.
servers:
  - url: https://test-api-kore.kravata.co
    description: Test
  - url: https://partners-api.kravata.co
    description: Production (mTLS + IP allowlist)
security:
  - bearerAuth: []
tags:
  - name: Authentication
  - name: Users
  - name: Accounts
  - name: Earn
  - name: Custody
  - name: Liquidity Ramps
  - name: Payments
  - name: Webhooks
paths:
  /api/v1/admin/fiats/balances/summary:
    get:
      tags:
        - Payments
      summary: Get FIAT Balance Summary
      description: >-
        Returns the aggregated fiat balance of your client across all of its
        users.


        #### Request


        | Field | Type | Required | Description |

        | --- | --- | --- | --- |

        | Authorization | Header | Yes | `Bearer <access_token>` obtained from
        **POST /api/v1/client/token**. |

        | currency | Query | Yes | Fiat currency (e.g. `COP`). |


        #### Response


        An array with one entry per currency:


        | Field | Description |

        | --- | --- |

        | currency | Fiat currency. |

        | totalAvailable | Sum of the available balances. |

        | totalPendingPayin | Sum of pay-ins not yet confirmed. |

        | totalPendingPayout | Sum of payouts in progress. |

        | userCount | Number of users with a balance. |
      operationId: get-fiat-balance-summary
      parameters:
        - name: currency
          in: query
          required: false
          description: ''
          schema:
            type: string
          example: COP
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    currency:
                      type: string
                    totalAvailable:
                      type: integer
                    totalPendingPayin:
                      type: integer
                    totalPendingPayout:
                      type: integer
                    userCount:
                      type: integer
              examples:
                fiats-balance-summary:
                  summary: fiats/balance summary
                  value:
                    - currency: COP
                      totalAvailable: 150000
                      totalPendingPayin: 200000
                      totalPendingPayout: 50000
                      userCount: 1
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Access token from POST /api/v1/client/token.

````