List a loan's findings

GET

/v1/loans/{ref}/findings

curl --request GET \
  --url http://localhost:8080/v1/loans/example/findings

Returns the findings of the latest reconciliation run, or of the run given by run. Filter by severity (exception, warning, info) and status (open, accepted, overridden, resolved). Empty until the loan has been reconciled. Any staff role or an API key with status:read. 404 for an unknown loan, 400 for an unknown severity or status.

Parameters

Path Parameters

ref

required

string

Query Parameters

run

string format: uuid

severity

string

status

string

Responses

200

OK

Media typeapplication/json

Array<object>

object

id

required

string format: uuid

runId

required

string format: uuid

loanId

required

string format: uuid

ruleId

required

string

severity

required

string

status

required

string

title

required

string

detail

required

Stored as findings.detail_json: the human sentence plus every source the finding points at.

object

message

required

string

sources

required

Array<object>

Where a finding points (document / page / box); the provenance the workstation deep-links to.

object

documentId

required

string format: uuid

source

required

string

field

required

null | string

value

required

null | string

pageNo

required

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

bbox

required

One of:

null

null

object

Page-relative box: fractions of page width/height, origin top-left, so it survives any render scale.

object

x

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

y

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

w

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

h

required

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

data

required

createdAt

required

string format: date-time

blocksApproval

required

boolean

Example^generated

[
  {
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "runId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "loanId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "ruleId": "example",
    "severity": "example",
    "status": "example",
    "title": "example",
    "detail": {
      "message": "example",
      "sources": [
        {
          "documentId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
          "source": "example",
          "field": "example",
          "value": "example",
          "pageNo": 1,
          "bbox": {
            "x": 1,
            "y": 1,
            "w": 1,
            "h": 1
          }
        }
      ],
      "data": "example"
    },
    "createdAt": "2026-04-15T12:00:00Z",
    "blocksApproval": true
  }
]