Developers

The VerifyResume API

Automate résumé-versus-LinkedIn verification and applicant management. Authenticate with a per-account API key and call the same endpoints the web app uses.

1. Get an API key

  1. Log in to your VerifyResume account.
  2. Open the Automate via API panel and click Generate API key.
  3. Copy the key — it's shown only once. It looks like rv_live_….
Keep it secret. A key acts as your account and can read and delete your applicant records. Store it as an environment variable, never in client-side code, and revoke it from the portal if it leaks. Records created with a key are private to your account.

2. Authenticate

Send your key in the X-API-Key header on every request. API requests are exempt from the browser CSRF check.

# Base URL
https://verifyresumeagainstlinkedin.com

# Every request carries your key
X-API-Key: rv_live_your_key_here

3. Endpoints

POST/api/verify

Verify a résumé against a LinkedIn profile. If an applicant object is included, the result is saved and its id returned.

curl -X POST https://verifyresumeagainstlinkedin.com/api/verify \
  -H "X-API-Key: rv_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "resume":  { ... },
    "profile": { ... },
    "applicant": { "name": "Jane Doe", "email": "jane@example.com" }
  }'

POST/api/applicant

Save an applicant record. Requires at least one of name, email, linkedIn, or resume.

curl -X POST https://verifyresumeagainstlinkedin.com/api/applicant \
  -H "X-API-Key: rv_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Jane Doe", "email": "jane@example.com" }'

GET/api/applicants

List your applicants, paginated. Query params: page, limit (max 100), search, sortBy, order.

curl "https://verifyresumeagainstlinkedin.com/api/applicants?page=1&limit=20" \
  -H "X-API-Key: rv_live_your_key_here"

GET/api/applicants/:id  ·  DELETE/api/applicants/:id

Fetch or delete a single applicant record you own.

curl https://verifyresumeagainstlinkedin.com/api/applicants/APPLICANT_ID \
  -H "X-API-Key: rv_live_your_key_here"

curl -X DELETE https://verifyresumeagainstlinkedin.com/api/applicants/APPLICANT_ID \
  -H "X-API-Key: rv_live_your_key_here"

Responses & errors

StatusMeaning
200 / 201Success. JSON body varies by endpoint.
400Invalid request — missing or malformed fields.
401Missing, invalid, or revoked API key.
404Record not found (or not owned by your account).
429Rate limited — slow down and retry.