▣ ARTIFICIAL INTELLIGENCE · DATA EXTRACTION

Resume Parser API

What it does

The Resume Parser API turns resumes and CVs into structured JSON your software can store, search, and filter. For each candidate, you get their contact details, work history with the skills used in each role, education, spoken languages, and certifications.

Send a PDF, DOC, DOCX, TXT, or RTF file, or a scan or photo in JPG, PNG, or TIFF format, which is read with OCR automatically. Resumes in 80+ languages are supported.

Use it to fill in applicant profiles in your ATS, build a searchable talent database, or process large volumes of applications without manual data entry. Parsing runs in the background: submit the file, then check the job status until the result is ready. Once parsed, you can rank candidates against a role with the Resume/CV Job Match Score API.

You can start on ApyHub's free tier with no card required.

▣ ENDPOINT 01 / 02

POST

Submit AI Resume Parser job

https://api.eu.apyhub.com/sharpapi/parse-resume

QUICKSTART

GUIDE

Quickstart

Upload a resume file to start an asynchronous parsing job.

curl -X POST "https://api.eu.apyhub.com/sharpapi/parse-resume" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/resume.pdf"

What you'll get back

Returns a JSON object with a job_id string — the UUID of the submitted job. Poll the job status endpoint with this id to retrieve the result.

{
  "job_id": "16e4a61a-2e1a-4ddf-87d5-8da9145144a9"
}

TRY ITLIVE · 50 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

About this endpoint

What it does

Submits a resume/CV file for asynchronous AI parsing and returns identifiers you can use to check the job's progress later. The request uploads the file to process, and the response gives you the job ID.

Request Body

Parameter	Type	Mandatory	Description
file	Binary	Yes	Resume/CV file upload. Supported formats: PDF, DOC, DOCX, TXT, or RTF.
language	String	No	Language of the resume. Defaults to English.

Response

Returns a JSON object with a job_id string — the UUID of the submitted job. Poll the job status endpoint with this id to retrieve the result.

Parameter	Type	Mandatory	Description
job_id	String	Yes	Identifier of the submitted asynchronous job. Format: UUID.

Notes

This endpoint kicks off an async job and returns immediately with a job identifier; the actual work runs in the background. Pair this call with the corresponding job_check endpoint — poll that until the status reaches a terminal state to retrieve the result. Use job_id from the response to track the job.

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ ENDPOINT 02 / 02

GET

Get AI Resume Parser job status

https://api.eu.apyhub.com/sharpapi/parse-resume/job/status/:job_id

QUICKSTART

GUIDE

Quickstart

Check the status of a parsed resume job by its job ID.

curl -X GET "https://api.eu.apyhub.com/sharpapi/parse-resume/job/status/:job_id" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with a data object. The data object includes id, type, and attributes; attributes contains the job status and, when available, a result object with the parsed resume details.

{
  "data": {
    "id": "job_123",
    "type": "job",
    "attributes": {
      "type": "resume_parse",
      "status": "completed",
      "result": {}
    }
  }
}

TRY ITLIVE · 1 ATOM

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Retrieves the current status of an AI resume parsing job by job ID. The response returns a JSON object containing a data object with the job identifier, job type, and nested attributes including status and, when available, parsed resume results.

Path Parameter(s)

Attribute	Type	Mandatory	Description
job_id	String	Yes	UUID format. Identifies the resume parsing job.

Response

Returns a JSON object with a data object. Inside data, the response includes id and type string fields, plus an attributes object containing type, result, and status fields.

Attribute	Type	Mandatory	Description
data	Object	Yes	Wrapper object for the job status payload.
data.id	String	Yes	Job identifier.
data.type	String	Yes	Job type.
data.attributes	Object	Yes	Wrapper object for the status and parsed result fields.
data.attributes.type	String	Yes	Attribute type.
data.attributes.status	String	Yes	Job status.
data.attributes.result	Object	No	Parsed resume data returned by the job when available.
data.attributes.result.positions	Object Array	No	Array of position entries extracted from the resume.
data.attributes.result.positions[].skills	String Array	No	Skills associated with the position.
data.attributes.result.positions[].country	String	No	Country associated with the position.
data.attributes.result.positions[].end_date	String	No	End date for the position. The schema marks this field as nullable.
data.attributes.result.positions[].start_date	String	No	Start date for the position.
data.attributes.result.positions[].job_details	String	No	Job details.
data.attributes.result.positions[].company_name	String	No	Company name.
data.attributes.result.positions[].position_name	String	No	Position name.
data.attributes.result.candidate_name	String	No	Candidate name.
data.attributes.result.candidate_email	String	No	Candidate email.
data.attributes.result.candidate_phone	String	No	Candidate phone.
data.attributes.result.candidate_address	String	No	Candidate address.
data.attributes.result.candidate_language	String	No	Candidate language.
data.attributes.result.education_qualifications	Object Array	No	Array of education qualification entries.
data.attributes.result.education_qualifications[].country	String	No	Country associated with the education record.
data.attributes.result.education_qualifications[].end_date	String	No	End date for the education record.
data.attributes.result.education_qualifications[].start_date	String	No	Start date for the education record.
data.attributes.result.education_qualifications[].degree_type	String	No	Degree type.
data.attributes.result.education_qualifications[].school_name	String	No	School name.
data.attributes.result.education_qualifications[].school_type	String	No	School type.
data.attributes.result.education_qualifications[].learning_mode	String	No	Learning mode.
data.attributes.result.education_qualifications[].education_details	String	No	Education details.
data.attributes.result.education_qualifications[].faculty_department	String	No	Faculty or department.
data.attributes.result.education_qualifications[].specialization_subjects	String	No	Specialization subjects.
data.attributes.result.candidate_spoken_languages	String Array	No	Spoken languages for the candidate.
data.attributes.result.candidate_honors_and_awards	Object Array	No	Honors and awards. The schema does not define the item shape.
data.attributes.result.candidate_courses_and_certifications	String Array	No	Courses and certifications for the candidate.

Notes

This endpoint is a job status check. Poll it with the job-id path parameter returned by the matching submit call. The data.attributes.status field indicates job progress and completion state, and the parsed resume fields are carried under data.attributes.result when the job has produced output.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLResume Parsing & Analysis APIDosvak LLC CALLResume/CV Job Match Score APISharpAPI CALLSkill Extraction APISumalya APIs CALLInvoice Parsing APISharpAPI

From the blog

Reads that touch this API.

Top 5 Free AI Resume Parsers for Recruiters in 2025Sep 10, 2026 Resume Parsing API: When You Need a Parser and When You Need a PipelineSep 10, 2026 Resume Parsing in 2026: Automate, Extract, Integrate FastJul 9, 2026 7 AI Hiring APIs to Automate Recruitment, From Job Post to Offer (2026)Aug 5, 2026