ResumeJSON

API reference

Generated from the same OpenAPI document the API serves at /openapi.json and RapidAPI imports to build the listing.

Endpoints

POST /v1/parse

Accepts a JSON body with a text field, a multipart form with a file part, or the file bytes as the raw request body. PDF and DOCX are detected from the bytes, not from the Content-Type header.

StatusMeaning
200The parsed resume.
400The body carried no resume.
403Not called through RapidAPI.
413Document larger than the limit.
415File type cannot be read.
422File unreadable, or the document is not a resume.
503Model upstream unavailable. Retry after the Retry-After delay.

GET /v1/health

Liveness and the active model

StatusMeaning
200Service is up.

Schemas

A nullable field is null whenever the resume does not state it. It is never an empty string and never the word "null".

Resume

FieldTypeNotes
basicsobject
workarray of WorkEntry
educationarray of EducationEntry
skillsarray of string
certificationsarray of object
languagesarray of object
total_years_experiencenumber | null

WorkEntry

FieldTypeNotes
companystring | null
titlestring | null
start_datestring | nullYYYY-MM, or YYYY when no month is stated.
end_datestring | nullnull when the role is current.
is_currentboolean
locationstring | null
highlightsarray of string

EducationEntry

FieldTypeNotes
institutionstring | null
degreestring | null
field_of_studystring | null
start_datestring | null
end_datestring | null

ParseResponse

FieldTypeNotes
resumeResume
metaobject

Error

FieldTypeNotes
errorobject

Date format

Every date field — start_date, end_date, a certification date — is one of exactly three things:

ValueMeansExample in the CV
"2022-03"Year and monthMarch 2022, Mar '22, 03/2022
"2016"Year only; the CV gave no month2014 – 2016
nullThe CV did not state it, or the role is currentPresent, Current, blank

Anything the model returns that is not one of those is dropped rather than passed through, so sorting by start_date is always a string comparison.