Skip to main content

Get an evaluation by lead id

GET 
/partner/pre-approve/:preLoanRequestId

Retrieves the current evaluation of one of your leads, addressed by its banca.me lead id (preLoanRequestId).

The mortgage and down-payment outcomes come back as sibling blocks with the same shape — hipotecario and pie — each carrying the same seven keys, always present, with null values when the lead has no pre-approval of that product type. When a lead has both, the mortgage block is the one to read.

Requires the evaluation module. The lead is resolved first: a partner without the module gets 404 for a lead that is not theirs and 403 for one that is.

Not found is deliberately uninformative​

A lead that does not exist, a lead that belongs to another partner, a lead with no valid evaluation, a lead with a valid BNPL pre-approval, and a 36-character id that is not a UUID all return the same 404 with the same body. This is intentional: distinguishing them would turn the endpoint into an oracle over which leads your competitors hold.

An id that is not 36 characters long never reaches the lookup: it is rejected with 422.

Expiry​

Expired pre-approvals are not returned. Mortgage and down-payment pre-approvals are returned for 28 days after they were created; other products for 14. When none of the lead's pre-approvals is still within that window, the response is the 404 above.

Request​

Responses​

Evaluation retrieved successfully