Inconsistency findings between ledger and rail (open or resolved), with a count per check

curl --request GET \
  --url https://api.example.com/v1/reconciliation/inconsistencies \
  --header 'Authorization: Bearer <token>'

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/reconciliation/inconsistencies"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.example.com/v1/reconciliation/inconsistencies', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "items": [
    {
      "amount": "1500.00",
      "check": "SETTLED_WITHOUT_COMMIT",
      "detail": "SETTLED transfer with no ledger_commit_id recorded.",
      "firstDetectedAt": "2026-10-22T13:10:00Z",
      "id": "d0a6b2c4-5e7f-4a91-8c3d-4e6f8a0b2c3d",
      "lastDetectedAt": "2026-10-22T13:40:00Z",
      "nuop": "87654321202610220000123",
      "observedStatus": "SETTLED",
      "organizationId": "0f1e2d3c-4b5a-4968-8776-655443322110",
      "resourceId": "6f1c2b3a-4d5e-4f60-8a9b-0c1d2e3f4a5b",
      "resourceType": "TRANSFER",
      "status": "OPEN"
    }
  ],
  "limit": 20,
  "next_cursor": null,
  "openByCheck": {
    "CREDIT_STATUS_CONTRADICTION": 0,
    "CREDIT_WITHOUT_FACT": 0,
    "LEDGER_STATUS_CONTRADICTION": 0,
    "ORPHAN_HOLD": 0,
    "RESERVED_AFTER_RELEASE": 0,
    "RETURN_WITHOUT_REFUND": 0,
    "RETURN_WITHOUT_REVERT": 0,
    "SETTLED_WITHOUT_COMMIT": 1
  },
  "prev_cursor": null
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Inconsistency findings between ledger and rail (open or resolved), with a count per check

Lists the differences found between the ledger and what the STR reported for the same resource. Example: a return received without the matching re-credit. A finding stays OPEN while the difference continues, and changes to CLEARED when the service no longer observes it.

By default, the list shows the OPEN findings, from oldest to newest. Filter by check, status, and resource type. openByCheck gives the count of open findings per check for the whole tenant, for the dashboard. Findings are informational: you make the fix in the resources they point to.

GET

reconciliation

inconsistencies

Inconsistency findings between ledger and rail (open or resolved), with a count per check

curl --request GET \
  --url https://api.example.com/v1/reconciliation/inconsistencies \
  --header 'Authorization: Bearer <token>'

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/reconciliation/inconsistencies"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.example.com/v1/reconciliation/inconsistencies', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "items": [
    {
      "amount": "1500.00",
      "check": "SETTLED_WITHOUT_COMMIT",
      "detail": "SETTLED transfer with no ledger_commit_id recorded.",
      "firstDetectedAt": "2026-10-22T13:10:00Z",
      "id": "d0a6b2c4-5e7f-4a91-8c3d-4e6f8a0b2c3d",
      "lastDetectedAt": "2026-10-22T13:40:00Z",
      "nuop": "87654321202610220000123",
      "observedStatus": "SETTLED",
      "organizationId": "0f1e2d3c-4b5a-4968-8776-655443322110",
      "resourceId": "6f1c2b3a-4d5e-4f60-8a9b-0c1d2e3f4a5b",
      "resourceType": "TRANSFER",
      "status": "OPEN"
    }
  ],
  "limit": 20,
  "next_cursor": null,
  "openByCheck": {
    "CREDIT_STATUS_CONTRADICTION": 0,
    "CREDIT_WITHOUT_FACT": 0,
    "LEDGER_STATUS_CONTRADICTION": 0,
    "ORPHAN_HOLD": 0,
    "RESERVED_AFTER_RELEASE": 0,
    "RETURN_WITHOUT_REFUND": 0,
    "RETURN_WITHOUT_REVERT": 0,
    "SETTLED_WITHOUT_COMMIT": 1
  },
  "prev_cursor": null
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Autorizaciones

Authorization

string

header

requerido

JWT token that the Lerian Access Manager issues for your institution. Send it in Authorization: Bearer <token> on every call (except the public health probes). The tenant never comes from the body, the query, or the path. Each operation requires a role with the matching permission (see the API overview). Without it, 403 TED-0071. Missing, invalid, or expired token: 401 TED-0070.

Encabezados

X-Request-Id

string<uuid>

Correlation identifier of this request (UUID). Optional: when you omit it, or when the value is not a well-formed UUID, the platform creates a UUID and returns it in the X-Request-Id header of the response. The resolved identifier goes to the logs, spans, and audit events of this request. Keep it to open a support ticket.

Parámetros de consulta

check

enum<string>[]

Checks to list, separated by commas. Missing = all.

Opciones disponibles:

RETURN_WITHOUT_REFUND,

ORPHAN_HOLD,

SETTLED_WITHOUT_COMMIT,

RESERVED_AFTER_RELEASE,

LEDGER_STATUS_CONTRADICTION,

CREDIT_WITHOUT_FACT,

CREDIT_STATUS_CONTRADICTION,

RETURN_WITHOUT_REVERT

status

enum<string>

predeterminado:OPEN

State of the findings: OPEN (default) or CLEARED.

Opciones disponibles:

OPEN,

CLEARED

resource_type

enum<string>

Resource type. Missing = both.

Opciones disponibles:

TRANSFER,

INCOMING_TRANSFER

limit

integer<int64>

predeterminado:20

Maximum items per page

Rango requerido: 1 <= x <= 100

cursor

string

Opaque cursor returned in next_cursor

Maximum string length: 512

Respuesta

Page of findings and, in openByCheck, the count of open findings per check across the whole tenant.

Page of inconsistency findings, with the count of open findings per check for the whole tenant.

items

object[]

requerido

Findings on the page.

Show child attributes

limit

integer<int64>

requerido

Actual page size, already limited to the contract maximum.

openByCheck

object

requerido

OPEN findings per check for the whole tenant, regardless of the filter. Always includes the eight checks.

Show child attributes

next_cursor

string | null

Token of the next page; null when there is none.

prev_cursor

string | null

Always null: the list only moves forward.

Resumen

API de Transferencias

API de TEDs recibidas

API de Conciliación

API de Operaciones

API de Políticas

API de Participantes

Manejo de errores

Inconsistency findings between ledger and rail (open or resolved), with a count per check

Autorizaciones

Encabezados

Parámetros de consulta

Respuesta