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"
  }
}

Authorizations

Authorization

string

header

required

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.

Headers

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.

Query Parameters

check

enum<string>[]

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

Available options:

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>

default:OPEN

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

Available options:

OPEN,

CLEARED

resource_type

enum<string>

Resource type. Missing = both.

Available options:

TRANSFER,

INCOMING_TRANSFER

limit

integer<int64>

default:20

Maximum items per page

Required range: 1 <= x <= 100

cursor

string

Opaque cursor returned in next_cursor

Maximum string length: 512

Response

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[]

required

Findings on the page.

Show child attributes

limit

integer<int64>

required

Actual page size, already limited to the contract maximum.

openByCheck

object

required

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.

Overview

Transfers API

Incoming Transfers API

Reconciliation API

Operations API

Policy API

Participants API

Error handling

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

Authorizations

Headers

Query Parameters

Response