Skip to main content

Get the latest evaluation by RUT

GET 

/partner/pre-approve/rut/:rut

Retrieves the evaluation of your most recent lead for a person, resolved among your own leads only.

A RUT may have leads with several partners. This endpoint always resolves the latest lead within your origins, never the latest in absolute terms, so one partner's data is never surfaced to another.

A lead created by a re-evaluation does not count as the latest until it has an evaluation of its own, so after a re-evaluation this endpoint keeps returning the evaluation it was based on.

Only that latest lead is read. If it has no valid evaluation, or it has a valid BNPL pre-approval, the answer is 404 even when an older lead of yours for the same RUT has a valid evaluation — read that lead with Get an evaluation by lead id.

The response is identical in shape to Get an evaluation by lead id.

Requires the evaluation module. The lead is resolved first: a partner without the module gets 404 for a RUT with no leads of theirs and 403 otherwise.

RUT format​

The RUT is normalised before lookup: every character other than digits and K is dropped — dots, hyphen, whitespace — and a K check digit is accepted in either case, so 12.345.678-9 and 12345678-9 resolve to the same lead. The last character is always read as the verifier digit, so the verifier digit is required.

This read is not stable over time​

Two identical calls can return different leads. "The latest" changes as soon as the person is evaluated again — that is the intended behaviour, not a defect.

Not found is deliberately uninformative​

A RUT with no leads of yours, a RUT unknown to banca.me, a malformed RUT, and a latest lead with no valid evaluation (or with a valid BNPL pre-approval) all return the same 404 with the same body, for the same anti-enumeration reason as the lookup by id.

Request​

Responses​

Evaluation retrieved successfully