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

# Actualizaciones de API de Midaz Cycle 6

> Nuevos endpoints de Midaz Cycle 6 para Ledger Settings, Balance History y Transaction Routes bidireccionales, con códigos de error actualizados y alineación con OpenAPI.

<Badge stroke icon="calendar-days" iconType="regular">30 de marzo de 2026</Badge> <Badge stroke icon="file-code" iconType="regular">Actualización de documentación</Badge> <Badge color="red" size="lg" stroke icon="triangle-exclamation" iconType="regular">Acción requerida</Badge>

## Afecta

***

Equipos que usan APIs de Midaz afectadas o planifican cambios de integración del Cycle 6.

Esta actualización aplica al portal público de documentación. No cambia el comportamiento de la API en tiempo de ejecución a menos que la documentación del producto enlazada indique lo contrario.

## Qué cambió

***

La documentación de la API de Midaz se actualizó para reflejar todos los cambios entregados en el **Cycle 6**. Esto incluye nuevos endpoints, schemas actualizados, filtros de consulta adicionales y nuevos códigos de error, todo localizado en inglés, portugués y español.

### Nuevos endpoints

***

### Ledger Settings

Dos nuevos endpoints permiten gestionar las reglas de validación por Ledger a través de la API:

* [**Retrieve Ledger Settings**](/es/reference/midaz/retrieve-ledger-settings): `GET /organizations/{id}/ledgers/{id}/settings`
* [**Update Ledger Settings**](/es/reference/midaz/update-ledger-settings): `PATCH /organizations/{id}/ledgers/{id}/settings`

Estos endpoints controlan si se aplica la **validación de Account Type** y la **validación de Route** para un Ledger específico.

### Balance History

Dos nuevos endpoints soportan **consultas de saldo en un momento determinado** para auditoría, conciliación y reportes históricos:

* [**Retrieve Balance History**](/es/reference/midaz/retrieve-balance-history): obtiene el estado de un saldo específico en un timestamp dado.
* [**Retrieve Balance History by Account**](/es/reference/midaz/retrieve-balance-history-by-account): obtiene el estado de todos los saldos de una cuenta en un timestamp dado.

<Warning>
  El parámetro `date` es obligatorio y debe seguir el formato `yyyy-mm-dd hh:mm:ss`. Si no existen datos de saldo para el timestamp especificado, se devuelve un error `404`.
</Warning>

### Schemas actualizados

***

### Transaction Routing

* **Operation Routes** ahora incluyen `accountingEntries` y soportan un tipo de ruta `bidirectional`
* **Transaction Routes** usan un nuevo formato de objeto `operationRoutes`
* **Operations** incluyen nuevos campos: `direction`, `routeId` y `routeCode`

La guía [Transaction Routing](/es/midaz/transaction-routing-entities) se actualizó para reflejar la nueva estructura y comportamiento.

### Nuevos filtros de consulta

***

| Endpoint           | Nuevos filtros                    |
| ------------------ | --------------------------------- |
| List Organizations | `legal_name`, `doing_business_as` |
| List Ledgers       | `name`                            |
| List Operations    | `direction`, `route_id`           |

### Nuevos códigos de error

***

Se agregaron los códigos de error **0140–0158** a la [referencia de errores](/es/reference/midaz/error-list), cubriendo fallos de validación para las nuevas funcionalidades de Ledger Settings y enrutamiento.

### Alineación de spec OpenAPI

***

Todas las specs de OpenAPI publicadas se alinearon con las versiones reales de la base de código:

| Spec           | Actualizada a  |
| -------------- | -------------- |
| Ledger         | v3.5.0         |
| CRM            | última estable |
| Fees Engine    | última estable |
| Access Manager | última estable |

## Impacto

***

Esta actualización de documentación incluye información que los equipos deben revisar antes de cambiar la integración o el despliegue afectados.

## Qué necesitas hacer

***

<Steps>
  <Step>
    Revisa la nueva documentación de Ledger Settings, Balance History, Transaction Routing, filtros y errores antes de tu próximo cambio de integración de Midaz.
  </Step>
</Steps>

### Plazo

Antes de tu próxima integración, despliegue o cambio de actualización relacionado.

### Por qué

La documentación pública se actualizó para reflejar el comportamiento de la API y la cobertura de endpoints del Cycle 6.