POST
/
v1
/
cv
/
extract
curl --request POST \
  --url https://app.fastgen.ai/v1/cv/extract \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --header 'Fastgen-Project: <fastgen-project>' \
  --form cv_file_url=https://myFileHost/myCv.pdf \
  --form async=true
{
  "personal_information": {
    "first_name": "<string>",
    "last_name": "<string>",
    "email": "<string>",
    "address": "<string>",
    "sex": "<string>",
    "phone_number": "<string>",
    "date_of_birth": "2023-12-25"
  },
  "skills": [
    {
      "skill": "<string>",
      "proficiency_level": "<string>"
    }
  ],
  "professional_experience": [
    {
      "company": "<string>",
      "description": "<string>",
      "start_date": "2023-12-25",
      "end_date": "2023-12-25",
      "position": "<string>",
      "location": "<string>",
      "internship": true,
      "work_type": "<string>"
    }
  ],
  "education": [
    {
      "school": "<string>",
      "degree": "<string>",
      "start_date": "2023-12-25",
      "end_date": "2023-12-25",
      "grade_text": "<string>",
      "grade_value": 123
    }
  ],
  "certifications": [
    {
      "issuer": "<string>",
      "start_date": "2023-12-25",
      "end_date": "2023-12-25",
      "credential_id": "<string>",
      "credential_url": "<string>",
      "name": "<string>"
    }
  ],
  "languages": [
    {
      "language": "<string>",
      "proficiency_level": "<string>"
    }
  ]
}

File Options

1. Direct File Upload

  • Submit the PDF file directly using multipart/form-data
  • Maximum file size: 30MB
  • Ideal for local files that need to be uploaded from a client application

2. URL Submission

  • Provide a publicly accessible URL where the PDF file is hosted
  • Maximum file size: 30MB
  • Useful for files that are already hosted online or stored in cloud storage
  • The API will download and process the file from the provided URL

Both methods expect PDF format files only and will return the same structured CV evaluation response.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Fastgen-Project
string
required

A unique identifier assigned to every Fastgen project. View your project IDs in the Fastgen Platform or via API request

Body

multipart/form-data

Response

200
application/json

OK

The response is of type object.