Developer API

Bring shortlisting to your own careers stack.

Call one endpoint with a candidate, a job, and a resume. Get back a ranked evaluation you can drop into your ATS or internal careers site. Priced separately from the Vetted dashboard — use both, or just this.

Authentication

Generate an API key from the admin console at Admin → API & Developers. Pass it as a bearer token on every request.

Authorization: Bearer vtd_live_••••••••••••••••

Keys can be rotated or revoked at any time. Never expose a key in client-side code.

POST /v1/evaluate

Submit a candidate for evaluation against a specific job.

curl -X POST https://api.vetted.example/v1/evaluate \
  -H "Authorization: Bearer $VETTED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_id": "3f4c...",
    "candidate": {
      "name": "Sarah Chen",
      "email": "sarah@example.com",
      "phone": "+1 415 555 0100"
    },
    "resume_url": "https://storage.example.com/sc-cv.pdf"
  }'

Response

A completed evaluation returns the full report. This is the only surface where scores are exposed — the raw feed to your own hiring team, not the candidate.

{
  "application_id": "app_29f...",
  "match_score": 92,
  "skills_matched": ["Kubernetes", "Go", "gRPC", "PostgreSQL"],
  "skills_missing": ["Terraform"],
  "summary": "Strong systems background with hands-on distributed experience...",
  "recommendation": "shortlist"
}

Rate limits & pricing

· 60 requests per minute on the Developer plan.
· 600 requests per minute on Scale.
· Billed per evaluation. See the API pricing tier.