Endpoint Examples

/parse

`POST` /parse

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.

Use the customParameters field with modeltype=llm to enable LLM-based processing (requires LLMParsingEnabled=true in the parse meta response for your locale). Default behavior uses LC Tag/ Standard parsing.

Headers

Name	Type	Description
`Content-Language`	string, enum	The locale code (example: `en-US`) for the language and country of the resume, if known.
`X-Release`	string	Release name to be used for the operation (e.g latest)
`content-type`	string, enum	Generated from available request content types. Allowed: `application/json` and `multipart/form-data` Default option: `application/json`

Code Examples

curl --request POST \
  --url https://lens.api.lightcast.io/resume/parse \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'Content-Language: en-US' \
  --header 'Content-Type: application/json' \
  --data '{"binaryData": "QWxleGFuZGVyIEYuIEFsbGlhcw0KNzUgQ29leW1hbiBBdmUNCkJsb29tZmllbGQgTkosIDA3MDAzDQooOTczKSAzMzgtMjUzOSAob2ZmaWNlKQ0KYWxsaWFzQGVyb2xzLmNvbSAgDQoNCkVEVUNBVElPTg0KDQpQQyBBZ2UgQ29tcHV0ZXIgTmV0d29ya2luZyBTY2hvb2w7IEZhaXJmaWVsZCwgTmV3IEplcnNleQkJCQk1Lzk4IC0gOS85OA0KRGlwbG9tYSAtIENvbXB1dGVyIE5ldHdvcmtpbmcNCg0KQmVya2xlZSBDb2xsZWdlOyBCb3N0b24sIE1hc3NhY2h1c2V0dHMJCQkJCQkJOC85NCAtIDUtOTcNCkJhY2hlbG9ycyBEZWdyZWUgLSBNdXNpYyBCdXNpbmVzcywgYW5kIFZvaWNlICBHUEE6IDMuNg0KDQpNb250Y2xhaXIgU3RhdGUgVW5pdmVyc2l0eTsgTW9udGNsYWlyLCBOZXcgSmVyc2V5CQkJCQk4LzkyIC0gNS85NA0KQnVzaW5lc3MgQWRtaW5pc3RyYXRpb24gYW5kIE11c2ljDQoNCkNFUlRJRklDQVRJT05TDQoNCk1DU0UgLSBNaWNyb3NvZnQgQ2VydGlmaWVkIFN5c3RlbXMgRW5naW5lZXINCk1DUCArIEludGVybmV0IC0gTWljcm9zb2Z0IENlcnRpZmllZCBQcm9mZXNzaW9uYWwgcGx1cyBJbnRlcm5ldA0KQ05BIC0gQ2VydGlmaWVkIE5vdmVsbCBBZG1pbmlzdHJhdG9yDQpBKyBNYWNpbnRvc2ggLSBDZXJ0aWZpZWQgVGVjaG5pY2FsIFN1cHBvcnQgU3BlY2lhbGlzdA0KQSsgV2luZG93cyBhbmQgRE9TIC0gQ2VydGlmaWVkIFRlY2huaWNhbCBTdXBwb3J0IFNwZWNpYWxpc3QNCg0KUVVBTElGSUNBVElPTlMgQU5EIFNLSUxMUw0KDQpQcm9maWNpZW50IGluIHRoZSBkZXNpZ24sIGltcGxlbWVudGF0aW9uIGFuZCBtYWludGVuYW5jZSBvZjoNCglNaWNyb3NvZnQgV2luZG93cyBOVCwgTm92ZWxsIE5ldHdhcmUgYW5kIEFwcGxlIE1hY2ludG9zaCBuZXR3b3JrIExBTi9XQU4gc3lzdGVtcy4NCg0KQ29tcGV0ZW50IGF0IHBlcmZvcm1pbmcgYWxsIHRhc2tzIHJlcXVpcmVkIG9mIGEgTWljcm9zb2Z0IFdpbmRvd3MgTlQgb3IgTm92ZWxsIE5ldHdhcmUgU3lzdGVtICBBZG1pbmlzdHJhdG9yLiBUaGVzZSB0YXNrcyBpbmNsdWRlIGJ1dCBhcmUgbm90IGxpbWl0ZWQgdG86DQoJTWFpbnRhaW5pbmcgYW5kIGVzdGFibGlzaGluZyB1c2VyIGFjY291bnRzOyBtYWludGFpbmluZyBhbmQgaW1wbGVtZW50aW5nIG5ldHdvcmsgc2VjdXJpdHksIGZpcmV3YWxsczsgdHJvdWJsZXNob290aW5nIHByaW50ZXIgcHJvYmxlbXM7IHV0aWxpemluZyBiYWNrdXAgZGV2aWNlczsgaW5zdGFsbGluZyBhbmQgbWFpbnRhaW5pbmcgZmF4LCBlLW1haWwgYW5kIGRhdGFiYXNlIHNlcnZlcnMuDQoNClNraWxsZWQgaW4gaW5zdGFsbGluZywgY29uZmlndXJpbmcsIG1hbmFnaW5nIGFuZCB0cm91Ymxlc2hvb3Rpbmcgb2Y6DQoJSUlTIC0gSW50ZXJuZXQgSW5mb3JtYXRpb24gU2VydmVyIHByb3ZpZGluZyBXV1csIEZUUCBhbmQgR29waGVyIHNlcnZpY2VzOyBUQ1AvSVAsIElQWC9TUFgsTmV0QkVVSSwgQXBwbGVUYWxrIGFuZCBSSVAgUHJvdG9jb2xzOyBESENQIC0gRHluYW1pYyBIb3N0IENvbmZpZ3VyYXRpb24gUHJvdG9jb2w7IFdJTlMgLVdpbmRvd3MgSW50ZXJuZXQgTmFtZSBTZXJ2aWNlOyBETlMgLSBEb21haW4gTmFtZSBTZXJ2aWNlLg0KDQpTa2lsbGVkIGluIHRoZSBpbnN0YWxsYXRpb24sIGNvbmZpZ3VyYXRpb24sIHN1cHBvcnQsIHRyb3VibGVzaG9vdGluZyBhbmQgbWFpbnRlbmFuY2Ugb2YgdmFyaW91cyBzb2Z0d2FyZSBvcGVyYXRpbmcgc3lzdGVtcyBpbmNsdWRpbmc6DQoJTWljcm9zb2Z0IFdpbmRvd3MgTlQgU2VydmVyLCBOVCBXb3Jrc3RhdGlvbiwgV2luZG93cyA5NSwgV2luZG93cyA5OCwgRE9TLCBXaW5kb3dzIGZvciBXb3JrZ3JvdXBzLCBBcHBsZSBNYWNpbnRvc2ggYW5kIE5vdmVsbCBOZXR3YXJlLg0KDQpTa2lsbGVkIGluIHRoZSBpbnN0YWxsYXRpb24sIGNvbmZpZ3VyYXRpb24sIHN1cHBvcnQsIHRyb3VibGVzaG9vdGluZyBhbmQgbWFpbnRlbmFuY2Ugb2YgdmFyaW91cyBuZXR3b3JrIGhhcmR3YXJlIGFuZCBwZXJpcGhlcmFscyBpbmNsdWRpbmc6DQpFdGhlcm5ldCwgQXJjTmV0IGFuZCBUb2tlbiBSaW5nIG5ldHdvcmtzOyBSb3V0ZXJzICwgQnJpZGdlcyBhbmQgR2F0ZXdheXM7IEZheCBhbmQgZGF0YSBtb2RlbXMsIENTVS9EU1UgbW9kZW1zOyBOZXR3b3JrZWQgUHJpbnRlcnM7IFNjYW5uZXJzOyBhbmQgdmFyaW91cyBNdWx0aW1lZGlhIHByb2R1Y3RzLg0KDQpTa2lsbGVkIGluIHRoZSB1c2Ugb2YgdmFyaW91cyBzdXBwb3J0IHV0aWxpdGllcyBpbmNsdWRpbmc6DQoJTWljcm8gSG91c2UgVGVjaG5pY2FsIExpYnJhcnkgKE1UTCksIE5vcnRvbiBVdGlsaXRpZXMsIENoZWNrSXRQcm8sIHZhcmlvdXMgYW50aS12aXJ1cyBhcHBsaWNhdGlvbnMgYW5kIHJlc291cmNlcyBvbiB0aGUgSW50ZXJuZXQuDQoNCkV4cGVyaWVuY2UgaW4gdGhlIHVzZSBvZiB2YXJpb3VzIGFwcGxpY2F0aW9uIHBhY2thZ2VzIGluY2x1ZGluZzoNCglNaWNyb3NvZnQgT2ZmaWNlLCB3aGljaCBpbmNsdWRlcyBXb3JkLCBFeGNlbCwgYW5kIFBvd2VyIFBvaW50OyBNUyBPdXRsb29rOyBNUyBFeGNoYW5nZTsgCQlDbGFyaXNXb3JrczsgUXVhcmsgRXhwcmVzczsgTmV0c2NhcGUgQ29tbXVuaWNhdG9yOyBOb3cgU29mdHdhcmUgYW5kIExvdHVzIE5vdGVzLg0KDQpQUk9GRVNTSU9OQUwgQ09NUFVURVIgUkVMQVRFRCBFWFBFUklFTkNFDQoNClN5c3RlbSBBZG1pbmlzdHJhdG9yDQpBcnQncyBIaWxsdG9wIERpc3RyaWJ1dG9yczsgQmxvb21maWVsZCwgTkoJCQkJCQkJNS85NyAtIFByZXNlbnQNCkRlc2lnbmVkLCBpbXBsZW1lbnRlZCBhbmQgY29uZmlndXJlZCBldGhlcm5ldCBuZXR3b3JrDQpJbnN0YWxsYXRpb24sIGNvbmZpZ3VyYXRpb24gYW5kIHRyb3VibGVzaG9vdGluZyBvZiBuZXR3b3JrIGhhcmR3YXJlIGFuZCBzb2Z0d2FyZQ0KTWFpbnRhaW5lZCB1c2VyIGFjY291bnRzIGFuZCBzZWN1cml0eQ0KDQpDb21wdXRlciBFbGVjdHJvbmljcyBBc3NvY2lhdGUNCk9mZmljZU1heDsgRG9yY2hlc3RlciwgTUEJCQkJCQkJCQk2Lzk1IC0gNS85Nw0KUHJvdmlkZWQgY29tcHV0ZXIgdGVjaG5pY2FsIHN1cHBvcnQgdG8gY3VzdG9tZXJzDQpJbnN0YWxsZWQgYW5kIG1haW50YWluZWQgY29tcHV0ZXJzIGFuZCBvdGhlciBlbGVjdHJvbmljcw0KU3VwZXJ2aXNlZCB0cmFja2luZyBhbmQgb3JnYW5pemluZyBvZiBlbGVjdHJvbmljcyBpbnZlbnRvcnkgDQoNCkZhY3VsdHkgQXNzaXN0YW50DQpCZXJrbGVlIENvbGxlZ2U7IEJvc3RvbiwgTUEJCQkJCQkJCQk4Lzk2IC0gNS85Nw0KTWFpbnRhaW5lZCBzb2Z0d2FyZSBpbnRlZ3JpdHkgb24gdGhlIGRlcGFydG1lbnRzIGNvbXB1dGVyIHN5c3RlbXMNClByb3ZpZGVkIG11c2ljIGVxdWlwbWVudCB0ZWNobmljYWwgYXNzaXN0YW5jZSB0byBmYWN1bHR5ICA=", "outputs": ["person"]}'

Request Body Example

The request body is semi-optional with multipart/form-data input.

{
  "binaryData": "string",
  "outputs": [
    "education"
  ]
}

Response Examples

{
  "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": "[email protected] \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.3128
            },
            "countryCode": "US",
            "countrySubDivisions": [
              {
                "type": "state",
                "value": "GA"
              }
            ],
            "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 in industries including Educational Services. 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. 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"
                      }
                    ],
                    "city": "San Antonio",
                    "line": "110 Inner Campus Dr.",
                    "postalCode": "78712"
                  }
                ]
              }
            },
            "educationDegrees": [
              {
                "name": "Bachelor of Commerce",
                "codes": [
                  "Bachelor of Commerce"
                ],
                "specializations": [
                  {
                    "type": "major",
                    "name": "Accounting"
                  },
                  {
                    "type": "minor",
                    "name": "Finance"
                  }
                ],
                "score": {
                  "scoresNumeric": [
                    {
                      "maximum": "4",
                      "value": "3"
                    }
                  ]
                },
                "academicHonors": [
                  "First class"
                ]
              }
            ],
            "educationLevelCodes": [
              {
                "id": {
                  "value": "16"
                }
              }
            ],
            "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."
                ]
              }
            ],
            "organization": {
              "name": "Chaney",
              "communication": {
                "address": [
                  {
                    "formattedAddress": "965 Wells Street, Lake Geneva, WI - 53147",
                    "geoLocation": {
                      "latitude": 42.59,
                      "longitude": -88.44
                    },
                    "countryCode": "US",
                    "countrySubDivisions": [
                      {
                        "type": "state",
                        "value": "WI"
                      }
                    ],
                    "city": "Lake Geneva",
                    "line": "965 Wells Street",
                    "postalCode": "53147"
                  }
                ]
              },
              "industryIdentifiers": [
                {
                  "value": "334519",
                  "schemeId": "NAICS"
                },
                {
                  "value": "8011",
                  "schemeId": "SIC"
                }
              ]
            }
          },
          {
            "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."
                ]
              }
            ],
            "organization": {
              "name": "Delavan-Darien School District",
              "communication": {
                "address": [
                  {
                    "formattedAddress": "Delavan, WI",
                    "geoLocation": {
                      "latitude": 42.62,
                      "longitude": -88.63
                    },
                    "countryCode": "US",
                    "countrySubDivisions": [
                      {
                        "type": "state",
                        "value": "WI"
                      }
                    ],
                    "city": "Delavan",
                    "postalCode": "53115"
                  }
                ]
              },
              "industryIdentifiers": [
                {
                  "value": "8211",
                  "schemeId": "SIC"
                }
              ]
            }
          }
        ],
        "qualifications": [
          {
            "competencyName": "customer support",
            "taxonomyIds": [
              {
                "schemeId": "ESCO Skills"
              }
            ],
            "competencyEvidence": {
              "evidenceName": "Surface Form",
              "descriptions": [
                "customer support"
              ]
            },
            "attachmentReferences": [
              {
                "uri": "#/profiles/employment/0"
              }
            ],
            "lastUsedDate": "2025",
            "experienceMeasure": {
              "value": 13,
              "unitCode": "ANN"
            }
          },
          {
            "competencyName": "german",
            "proficiencyLevel": {
              "scoresText": [
                {
                  "value": "CEFR:B2"
                }
              ]
            }
          }
        ],
        "licenses": [
          {
            "name": "registered nurse (rn)"
          }
        ],
        "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"
            }
          }
        ]
      }
    ]
  }
}

{
  "errors": [
    {
      "status": 400,
      "title": "Bad Request",
      "detail": "File size limit exceeded. Maximum allowed size is 10 MB."
    }
  ]
}

{
  "errors": [
    {
      "status": 401,
      "title": "Unauthorized Request",
      "detail": "You are not authorized to access this resource."
    }
  ]
}

{
  "errors": [
    {
      "status": 500,
      "title": "Internal Server Error",
      "detail": "Not able to read parser details"
    }
  ]
}

Parse Multipart/form-data

Parse resume file using multipart/form-data.

Code Examples

Standard parsing request:

curl --request POST \
  --url https://lens.api.lightcast.io/resume/parse \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'Content-Language: en-US' \
  --header 'content-type: multipart/form-data; boundary=---011000010111000001101001' \
  --form file=resume-sample.txt \
  --form outputs=education

LLM-based parsing request (for locales with LLMParsingEnabled=true):

curl --request POST \
  --url https://lens.api.lightcast.io/resume/parse \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'Content-Language: en-US' \
  --header 'content-type: multipart/form-data; boundary=---011000010111000001101001' \
  --form file=resume-sample.txt \
  --form outputs=education \
  --form customParameters=modeltype=llm

Form-data

The multipart/form-data input is semi-optional with the request body.

Name	Type	Description
`file`	file	The file upload that is to be parsed. This parameter is required.
`outputs`	string	The custom output to be extracted from the parsed resume, if known. This parameter is optional. Must be one of: `person`, `education`, `employment`, `qualifications`, `executiveSummary`, `rtfdoc`, `htmdoc`, `tagWithRTF`, `tagWithHTM`
`customParameters`	string	Advanced parsing configuration. Use `modeltype=llm` to enable LLM-based parsing for supported locales (check `LLMParsingEnabled` flag in `/resume/parse/meta` endpoint). Default behavior: standard parser with LC Tag parsing (`modeltype=lctag`). This parameter is optional. Supported values: `modeltype=llm` (LLM-based parsing), `modeltype=lctag` (LC Tag/Standard parsing)

`GET` /parse/meta

Returns metadata about the Parse Resume resource: supported outputs, locales, and request types.

Code Examples

curl --request GET \
     --url https://lens.api.lightcast.io/resume/parse/meta \
     --header 'accept: application/json' \
     --header 'authorization: Bearer <Access_Token>'

Response Examples

{
  "data": {
    "attribution": {
      "title": "Resume Classification API - Parse Resume",
      "body": "This resource performs the requested parse operation on a resume, including company name, title, and job description. A range of classifications may be performed on the resume based on requested outputs."
    },
    "supportsAutoLocaleDetection": true,
    "requestTypes": [
      "application/json",
      "multipart/form-data"
    ],
    "supportedOutputs": [
      "person",
      "education",
      "employment",
      "qualifications",
      "executiveSummary",
      "rtfdoc",
      "htmldoc",
      "tagWithRTF",
      "tagWithHTM"
    ],
    "availableLocales": [
      {
        "locale": "ld",
        "version": "8.38.2.1011",
        "versions": [
          "8.38.2.1011"
        ]
      },
      {
        "locale": "en_ca",
        "version": "9.1.2.23590",
        "versions": [
          {
            "version": "9.1.2.23590",
            "LLMSupportEnabled": true
          }
        ]
      },
      {
        "locale": "en_us",
        "version": "9.1.2.23590",
        "versions": [
          {
            "version": "9.1.2.23590",
            "LLMSupportEnabled": true
          }
        ]
      },
      {
        "locale": "en_gb",
        "version": "8.46.3.23004",
        "versions": [
          {
            "version": "8.46.3.23004",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_ie",
        "version": "8.46.3.23004",
        "versions": [
          {
            "version": "8.46.3.23004",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_au",
        "version": "8.46.3.23003",
        "versions": [
          {
            "version": "8.46.3.23003",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_nz",
        "version": "8.46.3.23003",
        "versions": [
          {
            "version": "8.46.3.23003",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_in",
        "version": "8.46.3.23007",
        "versions": [
          {
            "version": "8.46.3.23007",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_ar",
        "version": "8.43.9.19292",
        "versions": [
          {
            "version": "8.43.9.19292",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_br",
        "version": "8.43.9.19292",
        "versions": [
          {
            "version": "8.43.9.19292",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_mx",
        "version": "8.43.9.19292",
        "versions": [
          {
            "version": "8.43.9.19292",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "cn_cn",
        "version": "8.41.1.1074",
        "versions": [
          {
            "version": "8.41.1.1074",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "de_at",
        "version": "8.41.11.1429",
        "versions": [
          {
            "version": "8.41.11.1429",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "de_ch",
        "version": "8.41.11.1429",
        "versions": [
          {
            "version": "8.41.11.1429",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "de_de",
        "version": "8.45.6.1976",
        "versions": [
          {
            "version": "8.45.6.1976",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_at",
        "version": "8.43.4.1720",
        "versions": [
          {
            "version": "8.43.4.1720",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_ch",
        "version": "8.43.4.1720",
        "versions": [
          {
            "version": "8.43.4.1720",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_it",
        "version": "8.43.4.1720",
        "versions": [
          {
            "version": "8.43.4.1720",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_cn",
        "version": "8.41.4.1137",
        "versions": [
          {
            "version": "8.41.4.1137",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_de",
        "version": "8.42.2.1560",
        "versions": [
          {
            "version": "8.42.2.1560",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_hk",
        "version": "8.41.6.16529",
        "versions": [
          {
            "version": "8.41.6.16529",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_sg",
        "version": "8.41.6.16529",
        "versions": [
          {
            "version": "8.41.6.16529",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_pl",
        "version": "8.41.9.1307",
        "versions": [
          {
            "version": "8.41.9.1307",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_pt",
        "version": "8.41.9.1307",
        "versions": [
          {
            "version": "8.41.9.1307",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_tr",
        "version": "8.41.9.1307",
        "versions": [
          {
            "version": "8.41.9.1307",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "fr_ca",
        "version": "8.42.3.1574",
        "versions": [
          {
            "version": "8.42.3.1574",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "fr_ch",
        "version": "8.41.7.1242",
        "versions": [
          {
            "version": "8.41.7.1242",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "fr_dz",
        "version": "8.41.10.1373",
        "versions": [
          {
            "version": "8.41.10.1373",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "fr_ma",
        "version": "8.41.10.1373",
        "versions": [
          {
            "version": "8.41.10.1373",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "fr_tn",
        "version": "8.41.10.1373",
        "versions": [
          {
            "version": "8.41.10.1373",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "fr_fr",
        "version": "8.44.1.1835",
        "versions": [
          {
            "version": "8.44.1.1835",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "fr_be",
        "version": "8.44.1.1835",
        "versions": [
          {
            "version": "8.44.1.1835",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "it_it",
        "version": "8.44.2.20492",
        "versions": [
          {
            "version": "8.44.2.20492",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "du_be",
        "version": "8.41.12.1438",
        "versions": [
          {
            "version": "8.41.12.1438",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "du_nl",
        "version": "8.41.12.1438",
        "versions": [
          {
            "version": "8.41.12.1438",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "pl_pl",
        "version": "8.36.1.1249",
        "versions": [
          {
            "version": "8.36.1.1249",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "pt_br",
        "version": "8.36.1.1147",
        "versions": [
          {
            "version": "8.36.1.1147",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "pt_pt",
        "version": "8.36.1.1147",
        "versions": [
          {
            "version": "8.36.1.1147",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "es_ar",
        "version": "8.44.4.1958",
        "versions": [
          {
            "version": "8.44.4.1958",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "es_es",
        "version": "8.44.4.1958",
        "versions": [
          {
            "version": "8.44.4.1958",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "es_mx",
        "version": "8.44.4.1958",
        "versions": [
          {
            "version": "8.44.4.1958",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "es_cl",
        "version": "8.44.4.1958",
        "versions": [
          {
            "version": "8.44.4.1958",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_be",
        "version": "8.43.1.1698",
        "versions": [
          {
            "version": "8.43.1.1698",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_es",
        "version": "8.43.1.1698",
        "versions": [
          {
            "version": "8.43.1.1698",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_nl",
        "version": "8.43.1.1698",
        "versions": [
          {
            "version": "8.43.1.1698",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_fr",
        "version": "8.43.6.18964",
        "versions": [
          {
            "version": "8.43.6.18964",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_se",
        "version": "8.43.6.18964",
        "versions": [
          {
            "version": "8.43.6.18964",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_jp",
        "version": "8.43.3.1706",
        "versions": [
          {
            "version": "8.43.3.1706",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_za",
        "version": "8.43.7.19195",
        "versions": [
          {
            "version": "8.43.7.19195",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "ja_jp",
        "version": "8.42.8.1629",
        "versions": [
          {
            "version": "8.42.8.1629",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "sv_se",
        "version": "8.42.1.1548",
        "versions": [
          {
            "version": "8.42.1.1548",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "ru_ru",
        "version": "8.42.6.1603",
        "versions": [
          {
            "version": "8.42.6.1603",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "tr_tr",
        "version": "8.42.4.1581",
        "versions": [
          {
            "version": "8.42.4.1581",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "en_ae",
        "version": "8.43.12.19455",
        "versions": [
          {
            "version": "8.43.12.19455",
            "LLMSupportEnabled": false
          }
        ]
      },
      {
        "locale": "zh_tw",
        "version": "8.42.11.1655",
        "versions": [
          {
            "version": "8.42.11.1655",
            "LLMSupportEnabled": false
          }
        ]
      }
    ]
  }
}

`POST` /parse/versions/{version}

Performs the requested parse operation on a resume using the specified parser version. This endpoint uses the version path parameter.

Use the customParameters field with modeltype=llm to enable LLM-based processing (requires LLMParsingEnabled=true in the parse meta response for the version). Default behavior uses LC Tag/ Standard parsing.

Path Parameters

Name	Type	Description
`version`	string	Parser version to use for the operation.

Headers

Name	Type	Description
`Content-Language`	string	The locale code for the language and country of the resume, if known. This parameter is optional. Must be one of: `en-US`, `en-CA`, `en-AU`, `en-NZ`, `cn-CN`, `de-AT`, `de-CH`, `de-DE`, `en-AE`, `en-AR`, `en-BR`, `en-MX`, `en-AT`, `en-CH`, `en-IT`, `en-BE`, `en-ES`, `en-NL`, `en-CN`, `en-DE`, `en-FR`, `en-SE`, `en-GB`, `en-IE`, `en-HK`, `en-SG`, `en-IN`, `en-JP`, `en-PL`, `en-PT`, `en-TR`, `en-ZA`, `fr-CA`, `fr-CH`, `fr-FR`, `fr-BE`, `fr-DZ`, `fr-MA`, `fr-TN`, `it-IT`, `ja-JP`, `du-BE`, `du-NL`, `pl-PL`, `pt-PT`, `pt-BR`, `ru-RU`, `es-AR`, `es-ES`, `es-MX`, `es-CL`, `sv-SE`, `tr-TR`, `zh-TW`

Parse by Version Binary Data

Parse a resume with the specified parser version using binary data encoded in base64 format.

Code Examples

curl --request POST \
  --url https://lens.api.lightcast.io/resume/parse/versions/8.46.3.23013 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'Content-Language: en-US' \
  --header 'Content-Type: application/json' \
  --data '{"binaryData": "TmFtZTogUG9vaml0aGEKUm9sZTogU29mdHdhcmUgRW5naW5lZXIKU2tpbGxzOiBKYXZhLCBTcHJpbmcgQm9vdCwgUmVhY3QKRW1haWw6IHBvb2ppdGhhQGV4YW1wbGUuY29t", "outputs": ["education"]}'

Request Body Example

The request body is semi-optional with multipart/form-data input.

{
  "binaryData": "string",
  "outputs": [
    "education"
  ]
}

{
  "binaryData": "string",
  "outputs": [
    "education"
  ],
  "customParameters": "modeltype=llm"
}

Response Examples

{
  "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": "[email protected] \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.3128
            },
            "countryCode": "US",
            "countrySubDivisions": [
              {
                "type": "state",
                "value": "GA"
              }
            ],
            "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 in industries including Educational Services. 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. 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"
                      }
                    ],
                    "city": "San Antonio",
                    "line": "110 Inner Campus Dr.",
                    "postalCode": "78712"
                  }
                ]
              }
            },
            "educationDegrees": [
              {
                "name": "Bachelor of Commerce",
                "codes": [
                  "Bachelor of Commerce"
                ],
                "specializations": [
                  {
                    "type": "major",
                    "name": "Accounting"
                  },
                  {
                    "type": "minor",
                    "name": "Finance"
                  }
                ],
                "score": {
                  "scoresNumeric": [
                    {
                      "maximum": "4",
                      "value": "3"
                    }
                  ]
                },
                "academicHonors": [
                  "First class"
                ]
              }
            ],
            "educationLevelCodes": [
              {
                "id": {
                  "value": "16"
                }
              }
            ],
            "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."
                ]
              }
            ],
            "organization": {
              "name": "Chaney",
              "communication": {
                "address": [
                  {
                    "formattedAddress": "965 Wells Street, Lake Geneva, WI - 53147",
                    "geoLocation": {
                      "latitude": 42.59,
                      "longitude": -88.44
                    },
                    "countryCode": "US",
                    "countrySubDivisions": [
                      {
                        "type": "state",
                        "value": "WI"
                      }
                    ],
                    "city": "Lake Geneva",
                    "line": "965 Wells Street",
                    "postalCode": "53147"
                  }
                ]
              },
              "industryIdentifiers": [
                {
                  "value": "334519",
                  "schemeId": "NAICS"
                },
                {
                  "value": "8011",
                  "schemeId": "SIC"
                }
              ]
            }
          },
          {
            "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."
                ]
              }
            ],
            "organization": {
              "name": "Delavan-Darien School District",
              "communication": {
                "address": [
                  {
                    "formattedAddress": "Delavan, WI",
                    "geoLocation": {
                      "latitude": 42.62,
                      "longitude": -88.63
                    },
                    "countryCode": "US",
                    "countrySubDivisions": [
                      {
                        "type": "state",
                        "value": "WI"
                      }
                    ],
                    "city": "Delavan",
                    "postalCode": "53115"
                  }
                ]
              },
              "industryIdentifiers": [
                {
                  "value": "8211",
                  "schemeId": "SIC"
                }
              ]
            }
          }
        ],
        "qualifications": [
          {
            "competencyName": "customer support",
            "taxonomyIds": [
              {
                "schemeId": "ESCO Skills"
              }
            ],
            "competencyEvidence": {
              "evidenceName": "Surface Form",
              "descriptions": [
                "customer support"
              ]
            },
            "attachmentReferences": [
              {
                "uri": "#/profiles/employment/0"
              }
            ],
            "lastUsedDate": "2025",
            "experienceMeasure": {
              "value": 13,
              "unitCode": "ANN"
            }
          },
          {
            "competencyName": "german",
            "proficiencyLevel": {
              "scoresText": [
                {
                  "value": "CEFR:B2"
                }
              ]
            }
          }
        ],
        "licenses": [
          {
            "name": "registered nurse (rn)"
          }
        ],
        "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"
            }
          }
        ]
      }
    ]
  }
}

{
  "errors": [
    {
      "status": 400,
      "title": "Bad Request",
      "detail": "File size limit exceeded. Maximum allowed size is 10 MB."
    }
  ]
}

{
  "errors": [
    {
      "status": 401,
      "title": "Unauthorized Request",
      "detail": "You are not authorized to access this resource."
    }
  ]
}

{
  "errors": [
    {
      "status": 500,
      "title": "Internal Server Error",
      "detail": "Not able to read parser details"
    }
  ]
}

Parse by Version Multipart/form-data

Parse a resume file with the specified parser version using multipart/form-data.

Code Examples

curl --request POST \
  --url https://lens.api.lightcast.io/resume/parse/versions/8.46.3.23013 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'Content-Language: en-US' \
  --header 'content-type: multipart/form-data; boundary=---011000010111000001101001' \
  --form file=resume-sample.txt \
  --form outputs=education

Form-data

The multipart/form-data input is semi-optional with the request body.

Name	Type	Description
`file`	file	The file upload that is to be parsed. This parameter is required.
`outputs`	string	The custom output to be extracted from the parsed resume, if known. This parameter is optional. Must be one of: `person`, `education`, `employment`, `qualifications`, `executiveSummary`, `rtfdoc`, `htmdoc`, `tagWithRTF`, `tagWithHTM`
`customParameters`	string	Advanced parsing configuration. Use `modeltype=llm` to enable LLM-based parsing for supported locales (check `LLMParsingEnabled` flag in `/resume/parse/meta` endpoint). Default behavior: standard parser with LC Tag parsing (`modeltype=lctag`). This parameter is optional. Supported values: `modeltype=llm` (LLM-based parsing), `modeltype=lctag` (LC Tag/Standard parsing)

/parse

POST /parse

Headers

Code Examples

Request Body Example

Response Examples

Parse Multipart/form-data

Code Examples

Standard parsing request:

LLM-based parsing request (for locales with LLMParsingEnabled=true):

Form-data

GET /parse/meta

Code Examples

Response Examples

POST /parse/versions/{version}

Path Parameters

Headers

Parse by Version Binary Data

Code Examples

Request Body Example

Response Examples

Parse by Version Multipart/form-data

Code Examples

Form-data

`POST` /parse

`GET` /parse/meta

`POST` /parse/versions/{version}