Skip to main content

Open the evaluation report (informe) from its link

GET 

/partner/pre-approve/:signature/pdf

Redirects to the PDF report. This endpoint takes no API token.

This is the address that arrives as urlInforme in the pre_approve event and in the two evaluation reads. You do not assemble it — you receive it already built, and you open it.

Open it, do not call it​

A plain GET with no headers answers 302 and a Location pointing at a pre-signed download link. Most HTTP clients follow the redirect for you; a browser just shows the PDF. So the link works anywhere a link works: pasted in a browser, stored in a CRM field, put behind a "view report" button in your own platform.

Do not send your Authorization header. It is not needed here, and the second hop — the pre-signed storage link — rejects requests that carry one.

Why there is no token on a document with personal data​

The signature in the path is the credential, and it is a narrower one than your API token.

It is unguessable, and it is tamper-evident: banca.me re-checks the pre-approval it names against the stored record on every call, so editing the signature produces a 404, never a different document.

Getting one still requires a token. You either called an authenticated read, or you received it in a webhook whose destination only an authenticated partner could register. What changes is the blast radius if a link leaks: a signature opens one report, while your API token opens every read in the integration — evaluations, RUT lookups, the lead list, personal data. That is the whole reason this endpoint exists.

The report carries the lead's personal data, so anyone holding the link can read it.

The signature does not expire and cannot be revoked. There is no way to withdraw a link once it has been shared. Keep it inside systems you control — your CRM, your back office — and think twice before putting it in a forwardable email or anywhere publicly indexable.

The value changes on every read; the id does not​

Each read mints a fresh signature, so two consecutive calls for the same lead return different urlInforme values that open the same report. Older links keep working.

FieldStable across reads?Use it to
idPreAprobacionYescompare, deduplicate, key a cache
urlInformeNo — new on every readopen the report

If you diff API responses to detect changes, or cache by URL, key on idPreAprobacion. Otherwise you will see a change that did not happen, and store one cache entry per call.

SourceCarries urlInforme?
The pre_approve webhook eventYes
Get an evaluation by lead idYes
Get the latest evaluation by RUTYes
List leads — every rowNo — idPreAprobacion only
Get lead detailsNo — by design

The list is a summary and deliberately leaves the link out. For a lead you found there, use its idPreAprobacion with Get the evaluation report, or read the evaluation for that lead and take urlInforme from it.

If you would rather stay server to server​

Get the evaluation report is unchanged and still available: it takes your API token and the idPreAprobacion, and returns the pre-signed link as JSON instead of redirecting. Neither endpoint replaces the other.

This endpointGet the evaluation report
Path parametersignature, received in urlInformepreApproveId, i.e. idPreAprobacion
API tokenNot acceptedRequired
Answers302 to the signed link200 with { "data": { "url": ... } }
Good forsharing, embedding, pastingserver-to-server fetches

Both serve the identical document, and both re-render it under the same rule — see Get the evaluation report for when that happens.

Request​

Responses​

Redirect to the pre-signed download link, valid for 1800 seconds. The link forces a download named PreAprobacion_<preApproveId>.pdf.

Response Headers
    Location

    Pre-signed download link for the PDF. Fetch it with no Authorization header.