Parse a résumé

POST /parse/resume

Parse a résumé into normalized Candidate JSON: E.164 phone, canonical location, work history with computed tenures, taxonomy-normalized skills, education with degree levels, and a bias-redacted scoring_view used by /match.

Provide exactly one of text, url, or file. PDF files are processed natively; plain text is accepted; other binary formats return unsupported_format.

Cost: 1 credit.

Request body

Field	Type	Description
`text`	string	Raw document text
`url`	string	http(s) URL of a document (PDF or text; 25s fetch timeout; 10MB cap)
`file`	string	Base64-encoded document bytes (PDF or plain text; 10MB cap)

Example request


curl -X POST "https://api.rezmatch.ai/parse/resume" \
  -H "x-access-key: $TALENTKIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://files.example.com/resume.pdf"
}'

Example response


{
  "success": true,
  "data": {
    "candidate_id": "cand_9f2a41c07d13b6e8",
    "contact": {
      "name": "Priya Sharma",
      "email": "priya@example.com",
      "phone": "+15125550100",
      "location": "Austin, TX, United States",
      "links": [
        "https://github.com/priya"
      ]
    },
    "summary": "Backend engineer focused on distributed systems.",
    "total_experience_months": 103,
    "seniority": "senior",
    "work_history": [
      {
        "employer": "Acme Corp (Payments Division)",
        "employer_normalized": "Acme Corp",
        "title": "Senior Backend Engineer",
        "title_normalized": "Backend Engineer",
        "seniority": "senior",
        "start": "2021-03",
        "end": null,
        "tenure_months": 65,
        "skills": [
          "Go",
          "Kubernetes",
          "PostgreSQL"
        ],
        "highlights": [
          "Led migration to microservices"
        ]
      }
    ],
    "education": [
      {
        "institution": "University of Texas at Austin (Cockrell)",
        "institution_normalized": "University of Texas at Austin",
        "degree": "B.S.",
        "degree_level": "bachelor",
        "field": "Computer Science",
        "field_normalized": "Computer Science",
        "start": null,
        "end": "2018"
      }
    ],
    "skills": [
      {
        "raw": "golang",
        "canonical": "Go",
        "taxonomy_id": "skill_go"
      },
      {
        "raw": "Phlebotomy",
        "canonical": "Phlebotomy",
        "taxonomy_id": null
      }
    ],
    "certifications": [
      {
        "name": "CKA",
        "issuer": "CNCF",
        "year": 2022
      }
    ],
    "languages": [
      "English"
    ],
    "scoring_view": {
      "redacted_fields": [
        "name",
        "gender_proxies",
        "age_proxies",
        "photo"
      ],
      "features": {
        "skills": [
          "Go",
          "Kubernetes",
          "PostgreSQL"
        ],
        "seniority": "senior",
        "total_experience_months": 103
      }
    }
  },
  "credits_used": 1,
  "request_id": "req_7ed41a20-822f-4221-a674-cb84ebc74077"
}

Errors

Status	Meaning
`400`	invalid_request / unsupported_format
`401`	invalid_key — missing, unknown, or revoked access key
`402`	insufficient_credits — top up in the dashboard; the failed call is not charged
`422`	parse_failed — the document could not be structured

All errors share the error envelope.

Try it

Open this endpoint in the interactive playground — requests run with your API key.