> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Recuperar un Saldo > Usa este endpoint para recuperar un saldo específico por su identificador. ## OpenAPI ````yaml es/openapi/v3-current/ledger.yaml get /v2/organizations/{organization_id}/ledgers/{ledger_id}/balances/{balance_id} openapi: 3.1.0 info: title: API de Midaz Ledger version: 4.0.0 servers: - url: / security: [] tags: - name: Tipos de cuenta (v1) - name: Tipos de cuenta (v2) - name: Cuentas (v1) - name: Cuentas (v2) - name: Tasas de activos (v1) - name: Activos (v1) - name: Activos (v2) - name: Saldos (v1) - name: Saldos (v2) - name: Cálculo de facturación (v2) - name: Paquetes de facturación (v2) - name: Composición (v2) - name: Cifrado (v2) - name: Comisiones (v2) - name: Titulares (v2) - name: Instrumentos (v2) - name: Ledgers (v1) - name: Ledgers (v2) - name: Índices de metadatos (v1) - name: Índices de metadatos (v2) - name: Rutas de operaciones (v1) - name: Rutas de operaciones (v2) - name: Operaciones (v1) - name: Operaciones (v2) - name: Organizaciones (v1) - name: Organizaciones (v2) - name: Paquetes (v2) - name: Carteras (v1) - name: Carteras (v2) - name: Protección (v2) - name: Segmentos (v1) - name: Segmentos (v2) - name: Rutas de transacciones (v1) - name: Rutas de transacciones (v2) - name: Transacciones (v1) - name: Transacciones (v2) paths: /v2/organizations/{organization_id}/ledgers/{ledger_id}/balances/{balance_id}: get: tags: - Saldos (v2) summary: Recuperar un Saldo description: >- Usa este endpoint para recuperar un saldo específico por su identificador. operationId: getBalanceByIDV2 parameters: - description: Organization ID (UUID) in: path name: organization_id required: true schema: description: Organization ID (UUID) type: string - description: Ledger ID (UUID) in: path name: ledger_id required: true schema: description: Ledger ID (UUID) type: string - description: Balance ID (UUID) in: path name: balance_id required: true schema: description: Balance ID (UUID) type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/Balance' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Error' description: Error security: - BearerAuth: [] components: schemas: Balance: additionalProperties: false properties: accountId: examples: - 00000000-0000-0000-0000-000000000000 format: uuid type: string accountType: examples: - creditCard maxLength: 50 type: string alias: examples: - '@person1' maxLength: 256 type: string allowReceiving: examples: - true type: boolean allowSending: examples: - true type: boolean assetCode: examples: - USD maxLength: 10 minLength: 2 type: string available: examples: - '1500' minimum: 0 type: string createdAt: examples: - '2021-01-01T00:00:00Z' format: date-time type: string deletedAt: examples: - '2021-01-01T00:00:00Z' format: date-time type: - string - 'null' direction: examples: - credit type: string id: examples: - 00000000-0000-0000-0000-000000000000 format: uuid type: string key: examples: - asset-freeze maxLength: 100 type: string ledgerId: examples: - 00000000-0000-0000-0000-000000000000 format: uuid type: string metadata: additionalProperties: {} type: object onHold: examples: - '500' minimum: 0 type: string organizationId: examples: - 00000000-0000-0000-0000-000000000000 format: uuid type: string overdraftUsed: examples: - '0' type: string settings: $ref: '#/components/schemas/BalanceSettings' updatedAt: examples: - '2021-01-01T00:00:00Z' format: date-time type: string version: examples: - 1 format: int64 minimum: 1 type: integer required: - id - organizationId - ledgerId - accountId - alias - key - assetCode - available - onHold - version - accountType - allowSending - allowReceiving - overdraftUsed - createdAt - updatedAt - deletedAt type: object Error: additionalProperties: false properties: code: description: >- Stable, machine-readable domain error code scoped to the emitting service (format: -NNNN). examples: - ERR-0001 type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string upstream: $ref: '#/components/schemas/Upstream' description: >- RFC 9457 extension member: the error a proxied third-party provider reported. Absent unless the emitting service explicitly surfaced one. type: object BalanceSettings: additionalProperties: false properties: allowOverdraft: examples: - false type: boolean balanceScope: examples: - transactional type: string overdraftLimit: examples: - '1000.00' type: string overdraftLimitEnabled: examples: - false type: boolean required: - allowOverdraft - overdraftLimitEnabled type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object Upstream: additionalProperties: false properties: code: description: The upstream provider's own error code, verbatim. examples: - E4001 type: string message: description: >- The upstream provider's own error message, verbatim (bounded, never its raw response body). examples: - account not found at provider type: string type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT bearer token issued by the identity provider. scheme: bearer type: http ````