Skip to main content
POST
/
v2
/
recruiter
Get Candidate CV
curl --request POST \
  --url https://api.linkupapi.com/v2/recruiter \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "account_id": "<string>",
  "action": "<string>",
  "params": {
    "application_id": "<string>"
  }
}
'
{
  "success": true,
  "data": {
    "application_id": "26905743894",
    "candidate": {
      "name": "Jane Doe",
      "email": "[email protected]",
      "phone": "+33 6 12 34 56 78",
      "profile_url": "https://www.linkedin.com/in/jane-doe-42",
      "resume_url": "https://media.licdn.com/dms/document/..."
    },
    "cv": {
      "content": "JVBERi0xLjQKJfbk/N8KMSAwIG9iago8PAovVHlwZSAvQ2F0YW...",
      "encoding": "base64",
      "filename": "Jane_Doe_CV.pdf",
      "content_type": "application/pdf",
      "size_bytes": 126451
    }
  },
  "metadata": {
    "action": "get_cv",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}

​
Overview

Returns the CV/resume submitted by a candidate for a specific job application. The file content is returned inline as base64-encoded bytes alongside the candidate metadata — decode and write to disk to obtain the original file.
This endpoint consumes 1 credit per request.

​
Request

​
x-api-key
string
required
Your API key for authentication.
​
account_id
string
required
The unique identifier of the account to use.
​
action
string
required
Must be "get_cv".
​
params
object
required

​
Response

​
success
boolean
Indicates whether the request was successful.
​
data
object
​
metadata
object
{
  "success": true,
  "data": {
    "application_id": "26905743894",
    "candidate": {
      "name": "Jane Doe",
      "email": "[email protected]",
      "phone": "+33 6 12 34 56 78",
      "profile_url": "https://www.linkedin.com/in/jane-doe-42",
      "resume_url": "https://media.licdn.com/dms/document/..."
    },
    "cv": {
      "content": "JVBERi0xLjQKJfbk/N8KMSAwIG9iago8PAovVHlwZSAvQ2F0YW...",
      "encoding": "base64",
      "filename": "Jane_Doe_CV.pdf",
      "content_type": "application/pdf",
      "size_bytes": 126451
    }
  },
  "metadata": {
    "action": "get_cv",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}

​
Saving the CV to disk

The cv.content field is base64-encoded. Decode it and write it to a file using the cv.filename:
Python
import base64, json, requests

resp = requests.post(
    "https://api.linkupapi.com/v2/recruiter",
    headers={"x-api-key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
        "action": "get_cv",
        "account_id": "your-account-id",
        "params": {"application_id": "26905743894"},
    },
).json()

cv = resp["data"]["cv"]
with open(cv["filename"], "wb") as f:
    f.write(base64.b64decode(cv["content"]))
Node.js
import fs from "fs";

const resp = await fetch("https://api.linkupapi.com/v2/recruiter", {
  method: "POST",
  headers: { "x-api-key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    action: "get_cv",
    account_id: "your-account-id",
    params: { application_id: "26905743894" },
  }),
}).then(r => r.json());

const { filename, content } = resp.data.cv;
fs.writeFileSync(filename, Buffer.from(content, "base64"));