Skip to main content
Candidates

Download a candidate resume

Download a candidate's original resume through an authenticated redirect.

GET
/candidates/{candidateId}/resume/download

How it works

  1. Call this endpoint with your API credential.
  2. The API checks candidate ownership and resume-content access.
  3. A successful request returns 302 with a file URL valid for five minutes.

Do not forward the Authorization header to the file host. The temporary URL remains usable until it expires; do not log or persist it.

Missing, deleted or other-account resumes return 404.

See Find candidates and download resumes for examples and the direct-URL alternative.

Permissions

resumes.download

Authorizations

Authorizationstringheaderrequired

Use Authorization: Bearer <api-credential>.

Path Parameters

candidateIdnumberrequired
Example: 501

Response

Successful response. Redirects to a temporary URL for the original resume file; the response has no body.

X-API-Daily-Limitintegerheader

Daily account request allowance, when metered. Shared across API credentials.

Required range: 0 <= x
X-API-Daily-Remainingintegerheader

Requests remaining in the daily window after admission.

Required range: 0 <= x
X-API-Daily-Resetstringheader

Daily window reset time in UTC.

X-API-Monthly-Limitintegerheader

Monthly account request allowance, when metered. Shared across API credentials.

Required range: 0 <= x
X-API-Monthly-Remainingintegerheader

Requests remaining in the monthly window after admission.

Required range: 0 <= x
X-API-Monthly-Resetstringheader

Monthly window reset time in UTC.

X-Request-IDstringheader

Request correlation identifier. Supply this value when contacting support.

Example: 01J7Y8N9P0Q1R2S3T4U5V6W7X8
X-API-Contractstringheader

Response envelope contract version.

Example: canonical-v1
RateLimit-Limitintegerheader

Account request limit for capacity add-ons; effective credential request-unit limit for included legacy access.

Example: 600
RateLimit-Remainingintegerheader

Requests remaining for capacity add-ons, or request units for included legacy access.

Example: 598
RateLimit-Resetintegerheader

Seconds until the current minute window resets.

Example: 30
Locationstringheader

Temporary resume URL, valid for five minutes. Follow it without forwarding the Authorization header.

Example: https://files.cvviz.com/resumes/candidate-501.pdf?temporary=example
Cache-Controlstringheader
Example: private, no-store

Still need help? Ask the team