> ## 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 una Operación > Utilice este endpoint para recuperar los detalles de una Operación específica creada a partir de una Cuenta por su identificador. ## OpenAPI ````yaml es/openapi/v3-current/ledger.yaml get /v1/organizations/{organization_id}/ledgers/{ledger_id}/accounts/{account_id}/operations/{operation_id} openapi: 3.1.0 info: title: API de Midaz Ledger description: >- Referencia completa de la API para los servicios de Midaz Ledger, incluyendo gestión de organizaciones, operaciones de ledger, activos, segmentos, portafolios, cuentas, tipos de cuenta, transacciones, operaciones, saldos, rutas de operación, rutas de transacción e índices de metadatos. version: 3.7.8 servers: - url: https://ledger.sandbox.lerian.net security: [] tags: - name: Organizations API - name: Ledgers API - name: Assets API - name: Segments API - name: Portfolios API - name: Account Types API - name: Accounts API - name: Balances API - name: Transactions API - name: Operations API - name: Operation Routes API - name: Transaction Routes API - name: Metadata Indexes API - name: Holders API - name: Instruments API - name: Billing Packages API - name: Packages API - name: Billing Calculation API - name: Estimation API - name: Encryption API - name: Protection API - name: Asset Rates API paths: /v1/organizations/{organization_id}/ledgers/{ledger_id}/accounts/{account_id}/operations/{operation_id}: get: tags: - Operations API summary: Recuperar una Operación description: >- Utilice este endpoint para recuperar los detalles de una Operación específica creada a partir de una Cuenta por su identificador. parameters: - $ref: '#/components/parameters/OrganizationId' - $ref: '#/components/parameters/LedgerId' - $ref: '#/components/parameters/ContentType' - $ref: '#/components/parameters/AccountId' - $ref: '#/components/parameters/OperationId' - $ref: '#/components/parameters/XRequestId' - $ref: '#/components/parameters/Authorization' responses: '200': description: >- Indica que la solicitud fue exitosa y la respuesta contiene los datos esperados. content: application/json: schema: $ref: '#/components/schemas/GetOperationResponse' '401': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: Error0041: $ref: '#/components/examples/Error0041' Error0042: $ref: '#/components/examples/Error0042' '403': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: Error0043: $ref: '#/components/examples/Error0043' '404': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: Error0068: $ref: '#/components/examples/Error0068' '500': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorFormat' examples: Error0046: $ref: '#/components/examples/Error0046' components: parameters: OrganizationId: name: organization_id in: path description: El identificador único de la Organización asociada al Ledger. required: true example: 019c96a0-0a98-7287-9a31-786e0809c769 schema: type: string format: uuid LedgerId: name: ledger_id in: path description: El identificador único del Ledger asociado. required: true example: 019c96a0-0ac0-7de9-9f53-9cf842a2ee5a schema: type: string format: uuid ContentType: name: Content-Type in: header description: >- El tipo de medio del recurso. El valor recomendado es `application/json`. required: false example: application/json schema: type: string AccountId: name: account_id in: path description: El identificador único de la cuenta. required: true example: 019c96a0-0c0c-7221-8cf3-13313fb60081 schema: type: string format: uuid OperationId: name: operation_id in: path description: El identificador único de la operación que desea recuperar. required: true example: 019c96a0-10d2-7193-8841-0d7347efd09a schema: type: string format: uuid XRequestId: name: X-Request-Id in: header description: Un identificador único utilizado para rastrear y seguir cada solicitud. required: false example: 019c96a0-0a98-7287-9a31-786e0809c769 schema: type: string format: uuid Authorization: name: Authorization in: header required: false schema: type: string description: > Token JWT bearer para autenticación. Requerido cuando `PLUGIN_AUTH_ENABLED=true` (obligatorio en despliegues multiinquilino). Opcional en el modo OSS de inquilino único predeterminado. Formato: `Bearer ` schemas: GetOperationResponse: type: object properties: id: type: string description: El identificador único de la Operación. format: uuid transactionId: type: string format: uuid description: El identificador único de la Transacción. organizationId: type: string format: uuid description: El identificador único de la Organización. ledgerId: type: string description: El identificador único del Ledger. format: uuid accountId: type: string description: El identificador único de la Cuenta. format: uuid accountAlias: type: string description: El alias de la cuenta utilizada en la operación. balanceId: type: string description: El identificador único del Saldo. balanceKey: type: string description: La clave única que identifica el Saldo. description: type: string description: Descripción de la transacción. type: type: string description: >- El tipo de la operación. `OVERDRAFT` identifica operaciones companion generadas por el sistema en el saldo interno `"overdraft"` — `direction` lleva entonces la semántica del ciclo de vida (`debit` para un draw, `credit` para un reembolso). `BLOCK` y `UNBLOCK` identifican operaciones producidas por los endpoints de transacción de bloqueo/desbloqueo; `direction` sigue llevando la semántica de débito/crédito. enum: - CREDIT - DEBIT - ON_HOLD - RELEASE - OVERDRAFT - BLOCK - UNBLOCK assetCode: type: string description: El nombre del activo utilizado en la operación. chartOfAccounts: type: string description: El nombre del Plan de Cuentas al que pertenece la operación. route: type: string deprecated: true description: >- **Obsoleto.** Use `routeId` en su lugar. Se eliminará en la próxima versión mayor. routeId: type: string format: uuid description: >- El identificador único de la ruta de operación asociada a esta operación. Las operaciones companion de overdraft heredan este valor de la operación primaria que las generó. routeCode: type: string maxLength: 100 description: >- Un código legible de la ruta de operación, útil para auditoría y rastreabilidad. routeDescription: type: string description: La descripción de la ruta de operación asociada a esta operación. direction: type: string enum: - debit - credit description: La dirección de la operación en la contabilidad de partida doble. amount: type: object description: >- Un objeto que contiene información sobre el monto utilizado en la operación. properties: value: type: string description: El monto que se enviará. balance: type: object description: >- Un objeto que contiene información sobre el saldo antes de la operación. properties: available: type: string description: Saldo disponible anterior. onHold: type: string description: Monto retenido/reservado. version: type: integer description: Versión del saldo, que se actualiza con cada transacción. overdraftUsed: type: string description: >- El overdraft consumido por este saldo antes de la operación, como string decimal. `"0"` para operaciones que no tocan el overdraft. balanceAfter: type: object description: >- Un objeto que contiene información sobre el saldo después de la operación. properties: available: type: string description: Saldo disponible actual. onHold: type: string description: Monto retenido/reservado. version: type: integer description: Versión del saldo, que se actualiza con cada transacción. overdraftUsed: type: string description: >- El overdraft consumido por este saldo después de la operación, como string decimal. `"0"` para operaciones que no tocan el overdraft. status: type: object description: El estado de la transacción (pendiente, completada, revertida). properties: code: type: string description: Código de estado de la transacción. description: type: string description: Descripción del estado de la transacción. nullable: true balanceAffected: type: boolean description: >- Si es verdadero, indica que la operación afectó el saldo de la cuenta. createdAt: type: string format: date-time description: Fecha y hora de creación (UTC). updatedAt: type: string format: date-time description: Fecha y hora de la última actualización (UTC). deletedAt: type: string format: date-time description: Fecha y hora de la eliminación lógica, si aplica (UTC). nullable: true metadata: $ref: '#/components/schemas/Metadata' ErrorFormat: type: object description: El mensaje de error de respuesta. required: - code - title - message properties: code: type: string description: Un identificador único y estable para el error. title: type: string description: Un breve resumen del problema. message: type: string description: Orientación detallada para resolver el error. entityType: type: string description: >- El tipo de entidad a la que se refiere el error (p. ej. organization, ledger, account, transaction). Opcional. fields: type: object additionalProperties: true description: Información adicional sobre los campos que causaron el error. Metadata: type: object additionalProperties: oneOf: - type: string maxLength: 2000 - type: number - type: boolean description: >- Un objeto que contiene pares clave-valor para agregar como metadatos, donde el campo `name` es la clave y el campo `value` es el valor. Por ejemplo, para agregar un Centro de Costo, use `'costCenter': 'BR_11101997'`. **Restricciones:** las claves deben tener como máximo 100 caracteres; los valores de cadena de texto, como máximo 2000 caracteres. No se permiten objetos anidados (los valores deben ser cadena de texto, número o booleano), la estructura no puede exceder una profundidad máxima de 10, y se permite un máximo de 100 claves. examples: Error0041: summary: Token Missing value: code: '0041' title: Token Missing message: >- A valid token must be provided in the request header. Please include a token and try again. Error0042: summary: Invalid Token value: code: '0042' title: Invalid Token message: >- The provided token is expired, invalid or malformed. Please provide a valid token and try again. Error0043: summary: Insufficient Privileges value: code: '0043' title: Insufficient Privileges message: >- You do not have the necessary permissions to perform this action. Please contact your administrator if you believe this is an error. Error0068: value: code: 68 title: Operation ID Not Found message: >- The provided operation ID does not exist in our records. Please verify the operation ID and try again. summary: Operation ID Not Found Error0046: summary: Internal Server Error value: code: '0046' title: Internal Server Error message: >- The server encountered an unexpected error. Please try again later or contact support. ````