v1

latestOpenAPI 3.1.02026-07-242892032.8 MB
Classify Resume

Classify Resume

Performs the requested classification operation on a resume, including company name, title, and resume description. A range of classifications may be performed on the resume based on the requested outputs. Provides support to use different taxonomy. Use the customParameters field with modeltype=llm to enable LLM-based processing (requires LLMParsingEnabled=true in the classify meta response for your locale). Default behavior uses LC Tag/ Standard Classification.

post/resume/classify

Headers

Content-Language'en-US' | 'en-CA' | 'en-AU' | 'en-NZ' | 'en-GB' | 'en-IN'

The locale code (e.g. en-US) for the language and country of the resume, if known.

X-Releasestring

Release name to be used for the operation (e.g latest)

Request body

binaryDatastring required

Base64 encoded string of the document

outputsstring[]

Extract specific fields from the parsed response. Valid values: person, education, employment, qualifications, executiveSummary, rtfdoc, htmdoc, tagWithRTF, tagWithHTM

customParametersstring

Advanced parsing configuration. Use 'modeltype=llm' to enable LLM-based parsing for supported locales (check LLMParsingEnabled flag in /resume/parse/meta endpoint). Default: 'modeltype=lctag' (LC Tag classification)

Example request

{
  "binaryData": "TmFtZTogUG9vaml0aGEKUm9sZTogU29mdHdhcmUgRW5naW5lZXIKU2tpbGxzOiBKYXZhLCBTcHJpbmcgQm9vdCwgUmVhY3QKRW1haWw6IHBvb2ppdGhhQGV4YW1wbGUuY29t",
  "customParameters": "modeltype=lctag"
}

Response

OK

Example response

{
  "data": {
    "person": {
      "name": {
        "formattedName": "Mr. BEN(Ben) G. PENDER II",
        "given": "BEN",
        "middle": "G.",
        "family": "PENDER",
        "generationAffixCode": "II",
        "qualificationAffixCode": "M.B.A.",
        "preferredSalutationCode": "MR",
        "alias": "Ben"
      },
      "age": "37",
      "gender": "male",
      "communication": {
        "phone": [
          {
            "formattedNumber": "06-40875589 \n",
            "useCode": "fax"
          }
        ],
        "email": [
          {
            "address": "tvkastel@zonnet.nl \n"
          }
        ],
        "web": [
          {
            "name": "linkedin",
            "url": "http://www.linkedin.com/in/benpender"
          }
        ],
        "address": [
          {
            "formattedAddress": "Northwest Behavioral Medicine\tNorthwest Behavioral Research Center\n11755 Pointe Place, Suite A-1\t11755 Pointe Place, Suite A-1\nRoswell, GA 30076\tRoswell, GA 30076",
            "geoLocation": {
              "latitude": 34.025,
              "longitude": -84.313
            },
            "countryCode": "US",
            "countrySubDivisions": [
              {
                "type": "state",
                "value": "GA"
              },
              {
                "type": "msa",
                "value": "12060: Metropolitan Statistical Area"
              }
            ],
            "city": "Roswell",
            "line": "11755 Pointe Place, Suite A-1\t11755 Pointe Place, Suite A-1",
            "postalCode": "30076"
          }
        ]
      },
      "maritalStatus": "Married",
      "militaryStatus": "Attitude towards military service regulated",
      "legalDocuments": [
        {
          "documentType": "License",
          "value": "Code 08"
        }
      ],
      "birthDate": "1988-12-10",
      "birthPlace": "Roswell",
      "citizenship": "US",
      "legalId": {
        "description": "National ID",
        "value": "8606145375081"
      }
    },
    "profiles": [
      {
        "objective": "Senior Customer Support Representative - Team Lead - Chaney Customer Support. Language known - German",
        "executiveSummary": "I have 15 years of experience, including as a Senior Customer Support Representative - Team Lead and as a Substitute Teacher . Most recently, I have been working as a Senior Customer Support Representative - Team Lead from august, 2012 to December, 2025. My skills and experiences include: Customer Support, Early Childhood Education and Team Leadership. I have studied at The University of Texas.",
        "education": [
          {
            "id": {
              "value": "3"
            },
            "start": "2006-09-01",
            "end": "2009-09-01",
            "institution": {
              "name": "The University of Texas",
              "communication": {
                "address": [
                  {
                    "formattedAddress": "110 Inner Campus Dr., San Antonio, TX - 78712",
                    "geoLocation": {
                      "latitude": 29.47,
                      "longitude": -98.53
                    },
                    "countryCode": "US",
                    "countrySubDivisions": [
                      {
                        "type": "state",
                        "value": "TX"
                      },
                      {
                        "type": "msa",
                        "value": "41700: Metropolitan Statistical Area"
                      }
                    ],
                    "city": "San Antonio",
                    "line": "110 Inner Campus Dr.",
                    "postalCode": "78201"
                  }
                ]
              }
            },
            "educationDegrees": [
              {
                "name": "Bachelor of Commerce",
                "codes": [
                  "Bachelor's degree"
                ],
                "specializations": [
                  {
                    "type": "major",
                    "name": "Accounting",
                    "code": "52.0301"
                  },
                  {
                    "type": "minor",
                    "name": "Finance",
                    "code": "52.0801"
                  }
                ],
                "score": {
                  "scoresNumeric": [
                    {
                      "maximum": "4",
                      "value": "3"
                    }
                  ]
                },
                "academicHonors": [
                  "First class"
                ]
              }
            ],
            "educationLevelCodes": [
              {
                "id": {
                  "value": "2"
                }
              }
            ],
            "programs": [
              {
                "name": "Certified Public Accountant\n(FCA"
              },
              {
                "name": "Certified Management Accountant (CMA)"
              }
            ]
          }
        ],
        "employment": [
          {
            "id": {
              "value": "1"
            },
            "start": "2012-08-01",
            "current": true,
            "relatedCompetencies": {
              "competencyName": "Tenure",
              "experienceMeasure": {
                "value": "13",
                "unitCode": "ANN"
              }
            },
            "positionHistories": [
              {
                "title": "Senior Customer Support Representative - Team Lead",
                "descriptions": [
                  "Complete a wide range of assignments and tasks to provide support to customers (customer support) of the AcuRite and\\nassociated brands."
                ],
                "jobCategories": [
                  {
                    "id": {
                      "value": "15111013",
                      "schemeId": "Specialized Occupation",
                      "schemeAgencyId": "Lightcast"
                    },
                    "name": "Customer Service Representative (General)",
                    "score": {
                      "value": "1"
                    }
                  },
                  {
                    "id": {
                      "value": "151110",
                      "schemeId": "Occupation",
                      "schemeAgencyId": "Lightcast"
                    },
                    "name": "Customer Service Representative"
                  },
                  {
                    "id": {
                      "value": "1511",
                      "schemeId": "Occupation Group",
                      "schemeAgencyId": "Lightcast"
                    },
                    "name": "Customer Service Representatives"
                  },
                  {
                    "id": {
                      "value": "15",
                      "schemeId": "Career Area",
                      "schemeAgencyId": "Lightcast"
                    },
                    "name": "Customer and Client Support"
                  },
                  {
                    "id": {
                      "value": "43-4051.00",
                      "schemeId": "O*Net"
                    },
                    "name": "Customer Service Representatives"
                  },
                  {
                    "id": {
                      "value": "43-4051",
                      "schemeId": "SOC5"
                    },
                    "name": "Customer Service Representatives"
                  },
                  {
                    "id": {
                      "value": "4225",
                      "schemeId": "ISCO"
                    },
                    "name": "Inquiry Clerks"
                  },
                  {
                    "id": {
                      "value": "ET5D7F38487C955EB7",
                      "schemeId": "Lightcast Titles",
                      "schemeAgencyId": "Lightcast"
                    },
                    "name": "Customer Support Representatives",
                    "score": {
                      "value": "0.83"
                    }
                  }
                ]
              }
            ],
            "organization": {
              "id": {
                "value": "38030006",
                "schemeId": "Lightcast Companies",
                "schemeAgencyId": "Lightcast"
              },
              "name": "Chaney International S.A.S.",
              "communication": {
                "address": [
                  {
                    "formattedAddress": "965 Wells Street, Lake Geneva, WI - 53147",
                    "geoLocation": {
                      "latitude": 42.589,
                      "longitude": -88.44
                    },
                    "countryCode": "US",
                    "countrySubDivisions": [
                      {
                        "type": "state",
                        "value": "WI"
                      },
                      {
                        "type": "msa",
                        "value": "48580: Micropolitan Statistical Area"
                      }
                    ],
                    "city": "Lake Geneva",
                    "line": "965 Wells Street",
                    "postalCode": "53147"
                  }
                ]
              },
              "industryIdentifiers": [
                {
                  "value": "524210",
                  "schemeId": "NAICS"
                }
              ]
            }
          },
          {
            "id": {
              "value": "2"
            },
            "start": "2010-10-01",
            "end": "2012-07-01",
            "relatedCompetencies": {
              "competencyName": "Tenure",
              "experienceMeasure": {
                "value": "2",
                "unitCode": "ANN"
              }
            },
            "positionHistories": [
              {
                "title": "Substitute Teacher",
                "descriptions": [
                  "Work with a wide range of students from the Pre-Kindergarten level through high school."
                ],
                "jobCategories": [
                  {
                    "id": {
                      "value": "17171510",
                      "schemeId": "Specialized Occupation",
                      "schemeAgencyId": "Lightcast"
                    },
                    "name": "Substitute Teacher",
                    "score": {
                      "value": "1"
                    }
                  },
                  {
                    "id": {
                      "value": "171715",
                      "schemeId": "Occupation",
                      "schemeAgencyId": "Lightcast"
                    },
                    "name": "Substitute Teacher"
                  },
                  {
                    "id": {
                      "value": "1717",
                      "schemeId": "Occupation Group",
                      "schemeAgencyId": "Lightcast"
                    },
                    "name": "Teaching Support and Enrichment"
                  },
                  {
                    "id": {
                      "value": "17",
                      "schemeId": "Career Area",
                      "schemeAgencyId": "Lightcast"
                    },
                    "name": "Education and Training"
                  },
                  {
                    "id": {
                      "value": "25-3031.00",
                      "schemeId": "O*Net"
                    },
                    "name": "Substitute Teachers, Short-Term"
                  },
                  {
                    "id": {
                      "value": "25-3031",
                      "schemeId": "SOC5"
                    },
                    "name": "Substitute Teachers, Short-Term"
                  },
                  {
                    "id": {
                      "value": "2359",
                      "schemeId": "ISCO"
                    },
                    "name": "Teaching Professionals Not Elsewhere Classified"
                  },
                  {
                    "id": {
                      "value": "ET163A9A1E8C2953E3",
                      "schemeId": "Lightcast Titles",
                      "schemeAgencyId": "Lightcast"
                    },
                    "name": "Substitute Teachers",
                    "score": {
                      "value": "1"
                    }
                  }
                ]
              }
            ],
            "organization": {
              "id": {
                "value": "60757626",
                "schemeId": "Lightcast Companies",
                "schemeAgencyId": "Lightcast"
              },
              "name": "Delavan-Darien School District",
              "communication": {
                "address": [
                  {
                    "formattedAddress": "Delavan, WI",
                    "geoLocation": {
                      "latitude": 42.632,
                      "longitude": -88.645
                    },
                    "countryCode": "US",
                    "countrySubDivisions": [
                      {
                        "type": "state",
                        "value": "WI"
                      },
                      {
                        "type": "msa",
                        "value": "48580: Micropolitan Statistical Area"
                      }
                    ],
                    "city": "Delavan",
                    "postalCode": "53115"
                  }
                ]
              },
              "industryIdentifiers": [
                {
                  "value": "611110",
                  "schemeId": "NAICS"
                }
              ]
            }
          }
        ],
        "qualifications": [
          {
            "competencyName": "Customer Support",
            "taxonomyIds": [
              {
                "value": "KS120SR6WD1FP76Z6GC2",
                "schemeId": "Lightcast Skills",
                "schemeVersionId": "9.36",
                "schemeAgencyId": "Lightcast"
              }
            ],
            "competencyEvidence": {
              "evidenceName": "Surface Form",
              "descriptions": [
                "Customer Support",
                "customer support"
              ]
            },
            "score": {
              "value": "1"
            },
            "attachmentReferences": [
              {
                "uri": "#/profiles/employment/0"
              }
            ],
            "lastUsedDate": "2025",
            "experienceMeasure": {
              "value": 13,
              "unitCode": "ANN"
            }
          },
          {
            "competencyName": "Early Childhood Education",
            "taxonomyIds": [
              {
                "value": "KS1238Q6Q5K06K7QRKSJ",
                "schemeId": "Lightcast Skills",
                "schemeVersionId": "9.36",
                "schemeAgencyId": "Lightcast"
              }
            ],
            "competencyEvidence": {
              "evidenceName": "Surface Form",
              "descriptions": [
                "Pre-Kindergarten"
              ]
            },
            "score": {
              "value": "0.6"
            },
            "attachmentReferences": [
              {
                "uri": "#/profiles/employment/1"
              }
            ],
            "lastUsedDate": "2012",
            "experienceMeasure": {
              "value": 2,
              "unitCode": "ANN"
            }
          },
          {
            "competencyName": "Finance",
            "taxonomyIds": [
              {
                "value": "KS123MC78KV644P5DDZ0",
                "schemeId": "Lightcast Skills",
                "schemeVersionId": "9.36",
                "schemeAgencyId": "Lightcast"
              }
            ],
            "competencyEvidence": {
              "evidenceName": "Surface Form",
              "descriptions": [
                "Finance"
              ]
            },
            "score": {
              "value": "1"
            },
            "attachmentReferences": [
              {
                "uri": "#/profiles/education/0"
              }
            ]
          },
          {
            "competencyName": "German Language",
            "taxonomyIds": [
              {
                "value": "KS124BK6VD8Y1F11PD2Q",
                "schemeId": "Lightcast Skills",
                "schemeVersionId": "9.36",
                "schemeAgencyId": "Lightcast"
              }
            ],
            "competencyEvidence": {
              "evidenceName": "Surface Form",
              "descriptions": [
                "German"
              ]
            },
            "score": {
              "value": "0.99"
            }
          },
          {
            "competencyName": "Team Leadership",
            "taxonomyIds": [
              {
                "value": "KS4418462TTGKL3CWJHT",
                "schemeId": "Lightcast Skills",
                "schemeVersionId": "9.36",
                "schemeAgencyId": "Lightcast"
              }
            ],
            "competencyEvidence": {
              "evidenceName": "Surface Form",
              "descriptions": [
                "Team Lead"
              ]
            },
            "score": {
              "value": "0.53"
            },
            "attachmentReferences": [
              {
                "uri": "#/profiles/employment/0"
              }
            ],
            "lastUsedDate": "2025",
            "experienceMeasure": {
              "value": 13,
              "unitCode": "ANN"
            }
          },
          {
            "competencyName": "german",
            "proficiencyLevel": {
              "scoresText": [
                {
                  "value": "CEFR:B2"
                }
              ]
            }
          }
        ],
        "certifications": [
          {
            "name": "advanced cardiac life support ( acls )"
          }
        ],
        "personCompetency": [
          {
            "competencyName": "Average tenure",
            "experienceMeasure": {
              "value": "7.5",
              "unitCode": "ANN"
            }
          },
          {
            "competencyName": "Total years of experience",
            "experienceMeasure": {
              "value": "15",
              "unitCode": "ANN"
            }
          }
        ]
      }
    ]
  }
}