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.

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 BNPL lead, and a malformed id 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.

Expiry

Expired pre-approvals are not returned. Mortgage and down-payment pre-approvals are valid for 28 days; other products for 14.

Request

Responses

200

Evaluation retrieved successfully

400

Bad Request - Invalid or missing API token

403

Forbidden - Partner is inactive, or does not have the evaluation module

404

Not Found - The lead does not exist, belongs to another partner, has no valid evaluation, is a BNPL lead, or the id is malformed. All five cases return this same response.

429

Too Many Requests - Rate limit exceeded

503

Service Unavailable - An upstream read failed. banca.me renders infrastructure failures on this path as 503, not 500.