> ## 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 Ledger

> Usa este endpoint para recuperar los detalles de un Ledger específico por su identificador. Si se eliminó un Ledger, se mostrará su información, incluida la fecha de eliminación en el campo `deletedAt`.



## OpenAPI

````yaml es/openapi/v3-current/ledger.yaml get /v1/organizations/{organization_id}/ledgers/{ledger_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:
  /v1/organizations/{organization_id}/ledgers/{ledger_id}:
    get:
      tags:
        - Ledgers (v1)
      summary: Recuperar un Ledger
      description: >-
        Usa este endpoint para recuperar los detalles de un Ledger específico
        por su identificador. Si se eliminó un Ledger, se mostrará su
        información, incluida la fecha de eliminación en el campo `deletedAt`.
      operationId: getLedgerByID
      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
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Ledger'
          description: OK
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LegacyError'
          description: Error
      deprecated: true
      security:
        - BearerAuth: []
components:
  schemas:
    Ledger:
      additionalProperties: false
      properties:
        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'
        id:
          examples:
            - 00000000-0000-0000-0000-000000000000
          format: uuid
          type: string
        metadata:
          additionalProperties: {}
          type: object
        name:
          examples:
            - Treasury Operations
          maxLength: 256
          type: string
        organizationId:
          examples:
            - 00000000-0000-0000-0000-000000000000
          format: uuid
          type: string
        settings:
          $ref: '#/components/schemas/LedgerSettings'
        status:
          $ref: '#/components/schemas/Status'
        updatedAt:
          examples:
            - '2021-01-01T00:00:00Z'
          format: date-time
          type: string
      required:
        - id
        - name
        - organizationId
        - status
        - createdAt
        - updatedAt
        - deletedAt
      type: object
    LegacyError:
      additionalProperties: false
      properties:
        code:
          description: >-
            Stable, machine-readable midaz error code. Identical to the code /v2
            returns for the same condition.
          examples:
            - '0065'
          type: string
        entityType:
          description: >-
            The domain entity the error concerns. Present only on
            field-validation errors.
          examples:
            - Account
          type: string
        fields:
          additionalProperties: {}
          description: >-
            Per-field validation detail, keyed by field name. The value is the
            violation message for a known field and the offending value for an
            unexpected one, so it is not always a string. The /v2 contract
            carries these as the 'errors' array.
          type: object
        message:
          description: >-
            Human-readable explanation of this occurrence. The /v2 contract
            carries this as 'detail'.
          type: string
        title:
          description: Short, human-readable summary of the error.
          examples:
            - Invalid Path Parameter
          type: string
      required:
        - title
        - message
        - code
      type: object
    LedgerSettings:
      additionalProperties: false
      properties:
        accounting:
          $ref: '#/components/schemas/AccountingValidation'
        overrides:
          $ref: '#/components/schemas/OverridePolicy'
        tracer:
          $ref: '#/components/schemas/TracerSettings'
      required:
        - accounting
        - tracer
        - overrides
      type: object
    Status:
      additionalProperties: false
      properties:
        code:
          enum:
            - ACTIVE
            - INACTIVE
            - PENDING
            - SUSPENDED
            - DELETED
          examples:
            - ACTIVE
          maxLength: 100
          type: string
        description:
          examples:
            - Active status
          maxLength: 256
          type:
            - string
            - 'null'
      required:
        - code
        - description
      type: object
    AccountingValidation:
      additionalProperties: false
      properties:
        requireHolder:
          examples:
            - false
          type: boolean
        validateAccountType:
          examples:
            - false
          type: boolean
        validateRoutes:
          examples:
            - false
          type: boolean
      required:
        - validateAccountType
        - validateRoutes
        - requireHolder
      type: object
    OverridePolicy:
      additionalProperties: false
      properties:
        allowFeeSkip:
          examples:
            - false
          type: boolean
        allowHolderSkip:
          examples:
            - false
          type: boolean
        allowTracerSkip:
          examples:
            - false
          type: boolean
      required:
        - allowFeeSkip
        - allowTracerSkip
        - allowHolderSkip
      type: object
    TracerSettings:
      additionalProperties: false
      properties:
        failPosture:
          examples:
            - open
          type: string
        mode:
          examples:
            - 'off'
          type: string
        timeoutMs:
          examples:
            - 250
          format: int64
          type: integer
      required:
        - mode
        - failPosture
        - timeoutMs
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: JWT
      description: JWT bearer token issued by the identity provider.
      scheme: bearer
      type: http

````