Download a candidate resume

GET

/candidates/{candidateId}/resume/download

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

How it works

Call this endpoint with your API credential.

The API checks candidate ownership and resume-content access.

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

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🔵302Successful redirect

Successful response. Returns 302 Found and redirects to a temporary URL for the original resume file. The response has no body.

Headers

This response does not have a body.

🟠400

🟠401

🟠402

🟠403

🟠404

🟠429

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.cvviz.com/v1/candidates//resume/download' \
--header 'Authorization: Bearer <token>'

Response Example

400 - Example 1

{
    "type": "about:blank",
    "title": "Forbidden",
    "status": 403,
    "detail": "API credential does not grant the required scope",
    "instance": "/v1/jobs",
    "code": "CUSTOMER_API_RATE_LIMITED",
    "errors": [
        "string"
    ],
    "requestId": "01J7Y8N9P0Q1R2S3T4U5V6W7X8"
}

List candidate documents

List tasks

Download a candidate resume

How it works#

Permissions#

Request

Responses

How it works

Permissions