---
title: "Parse a resume"
method: POST
path: "/candidates/cv/parse"
tags: ["candidates"]
---

# Parse a resume

`POST /candidates/cv/parse`

Parse a resume

## Response `200`

Parsed candidate data.

- ParsedCandidateDetails
  - `firstName` string
  - `lastName` string
  - `email` string
  - `phoneNumber` string
  - `location` CandidateLocation
    - `country` string
    - `countryCode` string
    - `regionCode` string
    - `region` string
    - `city` string
    - `lat` number, float
    - `lng` number, float
  - `web` WebProfile
    - `skype` string
    - `linkedin` string
    - `facebook` string
    - `twitter` string
    - `website` string
  - `education` Education[]
    - `institution` string
    - `degree` string
    - `major` string
    - `current` boolean
    - `location` string
    - `startDate` string, when — date in YYYY, YYYY-MM or YYYY-MM-dd format, ex. "2016", "2016-11", "2016-11-29"
    - `endDate` string, when — date in YYYY, YYYY-MM or YYYY-MM-dd format, ex. "2016", "2016-11", "2016-11-29"
    - `description` string
  - `experience` Experience[]
    - `title` string
    - `company` string
    - `current` boolean
    - `startDate` string, when — date in YYYY, YYYY-MM or YYYY-MM-dd format, ex. "2016", "2016-11", "2016-11-29"
    - `endDate` string, when — date in YYYY, YYYY-MM or YYYY-MM-dd format, ex. "2016", "2016-11", "2016-11-29"
    - `location` string
    - `description` string

## Other responses

- `400` — with codes * **UNPARSABLE_RESUME** when provided resume cannot be parsed, e.g. an image * **INCOMPLETE_RESUME** when provided resume does not contain all required information to parse a candidate.
- `401` — Access denied.
- `403` — with code **PERMISSION_DENIED** when you are not permitted to parse resume
- `429` — Too many requests. Please try again later.

---

[API](https://skmtc.net/smartrecruiters/apis/apply-api.md) · [All operations](https://skmtc.net/smartrecruiters/apis/apply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartrecruiters/apply-api/versions/449bdc2516c9/schema)