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
- 200
- 400
- 401
- 403
- 404
- 429
- 503
Evaluation retrieved successfully
Bad Request - The token is not your current API token
Unauthorized - Missing or malformed token
Forbidden - Partner is inactive, or does not have the evaluation module
Not Found - No lead of yours matches this RUT, the RUT is unknown to banca.me, the RUT is malformed, or your latest lead for it has no valid evaluation or has a valid BNPL pre-approval. All of these cases return this same response.
Too Many Requests - Rate limit exceeded
Service Unavailable - An upstream read failed. banca.me renders infrastructure failures on
this path as 503, not 500.