POST
/
v1
/
cv
/
score
curl --request POST \
  --url https://app.fastgen.ai/v1/cv/score \
  --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 \
  --form 'scoring_template={ ... }' \
  --form scoring_template_id=f7c31bda-f918-4249-a3bc-9a1903fe9f6d \
  --form language=en
{
  "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>"
    }
  ],
  "ai_evaluation": {
    "candidate_info": {
      "name": "<string>",
      "position_applied": "<string>",
      "years_experience": 123
    },
    "professional_experience": {
      "score": 123,
      "weight": 123,
      "ai_reasoning": "<string>"
    },
    "education_qualifications": {
      "score": 123,
      "weight": 123,
      "ai_reasoning": "<string>"
    },
    "skills": {
      "score": 123,
      "weight": 123,
      "ai_reasoning": "<string>"
    },
    "additional_factors": {
      "score": 123,
      "weight": 123,
      "ai_reasoning": "<string>"
    },
    "total_score": 123,
    "summary_reasoning": "<string>",
    "recommended_interview_focus": "<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

Body

multipart/form-data

Response

200
application/json

Successful response

The response is of type object.