Endpoint Examples

/classify

GET /classify/meta

Returns metadata about the Classify Resume resource: supported outputs, locales, and request types with taxonomy version information.

Code Examples

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

Response Examples

{
  "data": {
    "attribution": {
      "title": "Resume Classification API - Classify Resume",
      "body": "This resource performs the requested classification 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. This endpoint parses the resume with support of custom skill Lightcast Taxonomies."
    },
    "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",
        "taxonomyVersionInfo": {
          "bgtres": {
            "taxonomyversioninfo": [
              {
                "taxonomy": [
                  {
                    "name": "cip_standard",
                    "version": "2.0.4"
                  },
                  {
                    "name": "companies",
                    "version": "2.91.0"
                  },
                  {
                    "name": "contract",
                    "version": "1.8.55"
                  },
                  {
                    "name": "employment",
                    "version": "1.8.55"
                  },
                  {
                    "name": "global_education_level",
                    "version": "2.3.14"
                  },
                  {
                    "name": "industry",
                    "version": "2.91.0"
                  },
                  {
                    "name": "internship",
                    "version": "1.8.55"
                  },
                  {
                    "name": "isced_standard",
                    "version": "2.1.38"
                  },
                  {
                    "name": "lot",
                    "version": "7.17.0"
                  },
                  {
                    "name": "skills",
                    "version": "9.43.0"
                  },
                  {
                    "name": "titles",
                    "version": "5.57.0"
                  }
                ]
              }
            ]
          }
        },
        "versions": [
          {
            "version": "9.1.2.23590",
            "LLMSupportEnabled": true,
            "taxonomyVersionInfo": [
              {
                "taxonomy": [
                  {
                    "name": "cip_standard",
                    "version": "2.0.4"
                  },
                  {
                    "name": "companies",
                    "version": "2.91.0"
                  },
                  {
                    "name": "contract",
                    "version": "1.8.55"
                  },
                  {
                    "name": "employment",
                    "version": "1.8.55"
                  },
                  {
                    "name": "global_education_level",
                    "version": "2.3.14"
                  },
                  {
                    "name": "industry",
                    "version": "2.91.0"
                  },
                  {
                    "name": "internship",
                    "version": "1.8.55"
                  },
                  {
                    "name": "isced_standard",
                    "version": "2.1.38"
                  },
                  {
                    "name": "lot",
                    "version": "7.17.0"
                  },
                  {
                    "name": "skills",
                    "version": "9.43.0"
                  },
                  {
                    "name": "titles",
                    "version": "5.57.0"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "locale": "en_us",
        "version": "9.1.2.23590",
        "taxonomyVersionInfo": {
          "bgtres": {
            "taxonomyversioninfo": [
              {
                "taxonomy": [
                  {
                    "name": "cip_standard",
                    "version": "2.0.4"
                  },
                  {
                    "name": "companies",
                    "version": "2.91.0"
                  },
                  {
                    "name": "contract",
                    "version": "1.8.55"
                  },
                  {
                    "name": "employment",
                    "version": "1.8.55"
                  },
                  {
                    "name": "global_education_level",
                    "version": "2.3.14"
                  },
                  {
                    "name": "industry",
                    "version": "2.91.0"
                  },
                  {
                    "name": "internship",
                    "version": "1.8.55"
                  },
                  {
                    "name": "isced_standard",
                    "version": "2.1.38"
                  },
                  {
                    "name": "lot",
                    "version": "7.17.0"
                  },
                  {
                    "name": "skills",
                    "version": "9.43.0"
                  },
                  {
                    "name": "titles",
                    "version": "5.57.0"
                  }
                ]
              }
            ]
          }
        },
        "versions": [
          {
            "version": "9.1.2.23590",
            "LLMSupportEnabled": true,
            "taxonomyVersionInfo": [
              {
                "taxonomy": [
                  {
                    "name": "cip_standard",
                    "version": "2.0.4"
                  },
                  {
                    "name": "companies",
                    "version": "2.91.0"
                  },
                  {
                    "name": "contract",
                    "version": "1.8.55"
                  },
                  {
                    "name": "employment",
                    "version": "1.8.55"
                  },
                  {
                    "name": "global_education_level",
                    "version": "2.3.14"
                  },
                  {
                    "name": "industry",
                    "version": "2.91.0"
                  },
                  {
                    "name": "internship",
                    "version": "1.8.55"
                  },
                  {
                    "name": "isced_standard",
                    "version": "2.1.38"
                  },
                  {
                    "name": "lot",
                    "version": "7.17.0"
                  },
                  {
                    "name": "skills",
                    "version": "9.43.0"
                  },
                  {
                    "name": "titles",
                    "version": "5.57.0"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "locale": "en_gb",
        "version": "8.46.3.23004",
        "taxonomyVersionInfo": {
          "bgtres": {
            "taxonomyversioninfo": [
              {
                "taxonomy": [
                  {
                    "name": "companies",
                    "version": "2.86.0"
                  },
                  {
                    "name": "contract",
                    "version": "1.8.52"
                  },
                  {
                    "name": "employment",
                    "version": "1.8.52"
                  },
                  {
                    "name": "global_education_level",
                    "version": "2.3.12"
                  },
                  {
                    "name": "industry",
                    "version": "2.86.0"
                  },
                  {
                    "name": "internship",
                    "version": "1.8.52"
                  },
                  {
                    "name": "isced_standard",
                    "version": "2.1.29"
                  },
                  {
                    "name": "lot",
                    "version": "7.12.0"
                  },
                  {
                    "name": "skills",
                    "version": "9.38.0"
                  },
                  {
                    "name": "titles",
                    "version": "5.52.0"
                  }
                ]
              }
            ]
          }
        },
        "versions": [
          {
            "version": "8.46.3.23004",
            "LLMSupportEnabled": false,
            "taxonomyVersionInfo": [
              {
                "taxonomy": [
                  {
                    "name": "companies",
                    "version": "2.86.0"
                  },
                  {
                    "name": "contract",
                    "version": "1.8.52"
                  },
                  {
                    "name": "employment",
                    "version": "1.8.52"
                  },
                  {
                    "name": "global_education_level",
                    "version": "2.3.12"
                  },
                  {
                    "name": "industry",
                    "version": "2.86.0"
                  },
                  {
                    "name": "internship",
                    "version": "1.8.52"
                  },
                  {
                    "name": "isced_standard",
                    "version": "2.1.29"
                  },
                  {
                    "name": "lot",
                    "version": "7.12.0"
                  },
                  {
                    "name": "skills",
                    "version": "9.38.0"
                  },
                  {
                    "name": "titles",
                    "version": "5.52.0"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "locale": "en_ie",
        "version": "8.46.3.23004",
        "taxonomyVersionInfo": {
          "bgtres": {
            "taxonomyversioninfo": [
              {
                "taxonomy": [
                  {
                    "name": "companies",
                    "version": "2.86.0"
                  },
                  {
                    "name": "contract",
                    "version": "1.8.52"
                  },
                  {
                    "name": "employment",
                    "version": "1.8.52"
                  },
                  {
                    "name": "global_education_level",
                    "version": "2.3.12"
                  },
                  {
                    "name": "industry",
                    "version": "2.86.0"
                  },
                  {
                    "name": "internship",
                    "version": "1.8.52"
                  },
                  {
                    "name": "isced_standard",
                    "version": "2.1.29"
                  },
                  {
                    "name": "lot",
                    "version": "7.12.0"
                  },
                  {
                    "name": "skills",
                    "version": "9.38.0"
                  },
                  {
                    "name": "titles",
                    "version": "5.52.0"
                  }
                ]
              }
            ]
          }
        },
        "versions": [
          {
            "version": "8.46.3.23004",
            "LLMSupportEnabled": false,
            "taxonomyVersionInfo": [
              {
                "taxonomy": [
                  {
                    "name": "companies",
                    "version": "2.86.0"
                  },
                  {
                    "name": "contract",
                    "version": "1.8.52"
                  },
                  {
                    "name": "employment",
                    "version": "1.8.52"
                  },
                  {
                    "name": "global_education_level",
                    "version": "2.3.12"
                  },
                  {
                    "name": "industry",
                    "version": "2.86.0"
                  },
                  {
                    "name": "internship",
                    "version": "1.8.52"
                  },
                  {
                    "name": "isced_standard",
                    "version": "2.1.29"
                  },
                  {
                    "name": "lot",
                    "version": "7.12.0"
                  },
                  {
                    "name": "skills",
                    "version": "9.38.0"
                  },
                  {
                    "name": "titles",
                    "version": "5.52.0"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "locale": "en_au",
        "version": "8.46.3.23003",
        "taxonomyVersionInfo": {
          "bgtres": {
            "taxonomyversioninfo": [
              {
                "taxonomy": [
                  {
                    "name": "companies",
                    "version": "2.86.0"
                  },
                  {
                    "name": "contract",
                    "version": "1.8.52"
                  },
                  {
                    "name": "employment",
                    "version": "1.8.52"
                  },
                  {
                    "name": "internship",
                    "version": "1.8.52"
                  },
                  {
                    "name": "isced_standard",
                    "version": "2.1.29"
                  },
                  {
                    "name": "lot",
                    "version": "7.12.0"
                  },
                  {
                    "name": "skills",
                    "version": "9.38.0"
                  },
                  {
                    "name": "titles",
                    "version": "5.52.0"
                  }
                ]
              }
            ]
          }
        },
        "versions": [
          {
            "version": "8.46.3.23003",
            "LLMSupportEnabled": false,
            "taxonomyVersionInfo": [
              {
                "taxonomy": [
                  {
                    "name": "companies",
                    "version": "2.86.0"
                  },
                  {
                    "name": "contract",
                    "version": "1.8.52"
                  },
                  {
                    "name": "employment",
                    "version": "1.8.52"
                  },
                  {
                    "name": "internship",
                    "version": "1.8.52"
                  },
                  {
                    "name": "isced_standard",
                    "version": "2.1.29"
                  },
                  {
                    "name": "lot",
                    "version": "7.12.0"
                  },
                  {
                    "name": "skills",
                    "version": "9.38.0"
                  },
                  {
                    "name": "titles",
                    "version": "5.52.0"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "locale": "en_nz",
        "version": "8.46.3.23003",
        "taxonomyVersionInfo": {
          "bgtres": {
            "taxonomyversioninfo": [
              {
                "taxonomy": [
                  {
                    "name": "companies",
                    "version": "2.86.0"
                  },
                  {
                    "name": "contract",
                    "version": "1.8.52"
                  },
                  {
                    "name": "employment",
                    "version": "1.8.52"
                  },
                  {
                    "name": "internship",
                    "version": "1.8.52"
                  },
                  {
                    "name": "isced_standard",
                    "version": "2.1.29"
                  },
                  {
                    "name": "lot",
                    "version": "7.12.0"
                  },
                  {
                    "name": "skills",
                    "version": "9.38.0"
                  },
                  {
                    "name": "titles",
                    "version": "5.52.0"
                  }
                ]
              }
            ]
          }
        },
        "versions": [
          {
            "version": "8.46.3.23003",
            "LLMSupportEnabled": false,
            "taxonomyVersionInfo": [
              {
                "taxonomy": [
                  {
                    "name": "companies",
                    "version": "2.86.0"
                  },
                  {
                    "name": "contract",
                    "version": "1.8.52"
                  },
                  {
                    "name": "employment",
                    "version": "1.8.52"
                  },
                  {
                    "name": "internship",
                    "version": "1.8.52"
                  },
                  {
                    "name": "isced_standard",
                    "version": "2.1.29"
                  },
                  {
                    "name": "lot",
                    "version": "7.12.0"
                  },
                  {
                    "name": "skills",
                    "version": "9.38.0"
                  },
                  {
                    "name": "titles",
                    "version": "5.52.0"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "locale": "en_in",
        "version": "8.46.3.23007",
        "taxonomyVersionInfo": {
          "bgtres": {
            "taxonomyversioninfo": [
              {
                "taxonomy": [
                  {
                    "name": "companies",
                    "version": "2.86.0"
                  },
                  {
                    "name": "contract",
                    "version": "1.8.52"
                  },
                  {
                    "name": "employment",
                    "version": "1.8.52"
                  },
                  {
                    "name": "industry",
                    "version": "2.86.0"
                  },
                  {
                    "name": "internship",
                    "version": "1.8.52"
                  },
                  {
                    "name": "isced_standard",
                    "version": "2.1.29"
                  },
                  {
                    "name": "lot",
                    "version": "7.12.0"
                  },
                  {
                    "name": "skills",
                    "version": "9.38.0"
                  },
                  {
                    "name": "titles",
                    "version": "5.52.0"
                  }
                ]
              }
            ]
          }
        },
        "versions": [
          {
            "version": "8.46.3.23007",
            "LLMSupportEnabled": false,
            "taxonomyVersionInfo": [
              {
                "taxonomy": [
                  {
                    "name": "companies",
                    "version": "2.86.0"
                  },
                  {
                    "name": "contract",
                    "version": "1.8.52"
                  },
                  {
                    "name": "employment",
                    "version": "1.8.52"
                  },
                  {
                    "name": "industry",
                    "version": "2.86.0"
                  },
                  {
                    "name": "internship",
                    "version": "1.8.52"
                  },
                  {
                    "name": "isced_standard",
                    "version": "2.1.29"
                  },
                  {
                    "name": "lot",
                    "version": "7.12.0"
                  },
                  {
                    "name": "skills",
                    "version": "9.38.0"
                  },
                  {
                    "name": "titles",
                    "version": "5.52.0"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}

POST /classify

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 taxonomies.

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.

Header

Leave Content-Language as empty or don't include the Content-Language header for auto locale detection based parsing.

NameTypeDescription
Content-LanguagestringThe 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, en-GB, en-IN
X-ReleasestringRelease name to be used for the operation (for example: latest).
This parameter is optional and applicable only for Enterprise access.

Classify Binary Data

Classify resume using its binary data encoded in base64 format.

Code Examples

curl --request POST \
  --url https://lens.api.lightcast.io/resume/classify \
  --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.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"
            }
          }
        ]
      }
    ]
  }
}
{
  "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"
    }
  ]
}

Classify Multipart/form-data

Classify resume file using multipart/form-data.

Code Examples

curl --request POST \
  --url https://lens.api.lightcast.io/resume/classify \
  --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.

NameTypeDescription
filefileThe file upload that is to be parsed.
This parameter is required.
outputsstringThe 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
customParametersstringAdvanced 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)

POST /classify/versions/{version}

The input file is either uploaded as multipart/form-data or raw json in the request body. This endpoint uses the {version} path parameter to select the classifier version.

Headers

Leave Content-Language as empty or don't include the Content-Language header for auto locale detection based parsing.

NameTypeDescription
Content-LanguagestringThe locale code (example: en-US) 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 , en-GB , en-IN

Path Parameters

NameTypeDescription
versionstringParser/classifier version to use for the operation.

Classify by Version Binary Data

Classify a resume with the specified classifier version using binary data encoded in base64 format.

Code Examples

curl --request POST \
  --url https://lens.api.lightcast.io/resume/classify/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"
  ]
}

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.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"
            }
          }
        ]
      }
    ]
  }
}
{
  "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"
    }
  ]
}

Classify by Version Multipart/form-data

Classify a resume file with the specified classifier version using multipart/form-data.

Code Examples

curl --request POST \
  --url https://lens.api.lightcast.io/resume/classify/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.

NameTypeDescription
filefileThe file upload that is to be parsed.
This parameter is required.
outputsstringThe 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