Exported Application Evaluation

Receive Exported Application Evaluation

All exported application evaluations can be retrieved from the Middleware Platform when a webhook event is received from the ATS partner. Use the id provided in the application evaluation webhook to access the data.

Note

The latest API version is 202604. Use this version in the LinkedIn-Version header for all API requests to access the most recent features and improvements.

Use the following endpoint to receive the application evaluation.

GET https://api.linkedin.com/rest/exportedApplicationEvaluation?q=request&requestId=123abc

Throttle Limits

Endpoint Requests Per Day (UTC) Records Per Minute
rest/exportedApplicationEvaluation 100,000 N/A

Note

  • Evaluation of an application will happen only once in 24 hour.
  • If there is any change in the underlying job then relevant applications might again be evaluated and send to the ATS partner.

Note

  • The requestId sent by push notification will expire in 24 hours.

Sample Request

GET 'https://api.linkedin.com/rest/exportedApplicationEvaluation?q=request&requestId=123abc' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {access_token}' \
--header 'LinkedIn-Version: 202507'
GET 'https://api.linkedin.com/rest/exportedApplicationEvaluation?q=request&requestId=123abc' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {access_token}' \
--header 'LinkedIn-Version: 202508'
GET 'https://api.linkedin.com/rest/exportedApplicationEvaluation?q=request&requestId=123abc' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {access_token}' \
--header 'LinkedIn-Version: 202508.02'
GET 'https://api.linkedin.com/rest/exportedApplicationEvaluation?q=request&requestId=123abc' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {access_token}' \
--header 'LinkedIn-Version: 202510'
GET 'https://api.linkedin.com/rest/exportedApplicationEvaluation?q=request&requestId=123abc' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {access_token}' \
--header 'LinkedIn-Version: 202511'
GET 'https://api.linkedin.com/rest/exportedApplicationEvaluation?q=request&requestId=123abc' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {access_token}' \
--header 'LinkedIn-Version: 202512'
GET 'https://api.linkedin.com/rest/exportedApplicationEvaluation?q=request&requestId=123abc' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {access_token}' \
--header 'LinkedIn-Version: 202602'
GET 'https://api.linkedin.com/rest/exportedApplicationEvaluation?q=request&requestId=123abc' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {access_token}' \
--header 'LinkedIn-Version: 202603'
GET 'https://api.linkedin.com/rest/exportedApplicationEvaluation?q=request&requestId=123abc' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {access_token}' \
--header 'LinkedIn-Version: 202604'

API Response Schema

Field Description Format
applicationEvaluation The application evaluation information. ApplicationEvaluation
atsApplicationId The reference for atsJobApplicationId string in case of RSC (offsite). String
jobRequisitionId The reference to the external RSC job requisition you created for the associated application. It is populated when the application is synced through RSC. String
jobApplicationId The JobApplicationUrn string used for Apply Connect (onsite) applications, e.g., urn:li:jobApplication:{application_id}. String
externalJobPostingId The reference identifier of the external job in your system to which the applicant applied. This field is populated for applications received via Apply Connect. String
integrationContext The identifier of the customer's OrganizationUrn (i.e. urn:li:organization:{LinkedIn_Company_Id}). String
source The source of the application evaluation. E.g. “LinkedIn”. String

ApplicationEvaluation Response Schema

Field Description Format
summary The candidate's evaluation brief with semantic information. String
evaluatedAt The epoch time (in milliseconds) when an application is evaluated. Long
evaluationClassification The overall classification of the candidate's application evaluation. This indicates the fit of the candidate for the role. The value would be any one of the following:
  • TOP_FIT
  • MIGHT_BE_FIT
  • MIGHT_NOT_BE_FIT
  • UNKNOWN
Enum
requiredCriteriaExplanations The list of explanations for required qualifications. CandidateCriteriaExplanation[]
preferredCriteriaExplanations The list of explanations for preferred qualifications. CandidateCriteriaExplanation[]
requiredCriteriaCount The count of required qualifications. Integer
requiredCriteriaMatchCount The count of required qualifications that match the candidate. Integer
preferredCriteriaCount The count of preferred qualifications. Integer
preferredCriteriaMatchCount The count of preferred qualifications that match the candidate. Integer
totalCriteriaCount The count of total qualifications. Integer
totalCriteriaMatchCount The count of total qualifications that match the candidate. Integer
evaluationProfileUrl Link to profile in Recruiter. A URL that points to the candidate's Recruiter profile page in the specific project that the evaluation was conducted in. String

CandidateCriteriaExplanation Response Schema

Field Description Format
criteria The hiring intent criteria that the explanation is for. String
criteriaClassification The classification of hiring intent criteria for a candidate. The value would be any one the following:
  • Meets (The candidate meets the criteria.)
  • Does not meet (The candidate does not meet or only partially meets the criteria.)
  • Unknown (The candidate can’t be evaluated.)
String
explanationSource Source of the explanation. It would be one the following. LinkedIn, ATS, CRM, Unknown String

Sample Response

A successful request returns a 200 OK response code, and you will find the status of the entity in the response body. BATCH_GET is not supported.

Sample Response Body

{
  "paging": {
    "start": 0,
    "count": 10,
    "links": []
  },
  "elements": [
    {
      "atsApplicationId": "efe0ca59-f52d-42b7-9036-b834fb3675dd",
      "source": "LinkedIn",
      "applicationEvaluation": {
        "summary": "Ranran has over 8 years of experience in software engineering and holds a Master's and Bachelor's degree in Computer Science.",
        "evaluationClassification": "TOP_FIT",
        "totalCriteriaCount": 2,
        "totalCriteriaMatchCount": 2,
        "preferredCriteriaExplanations": [
          {
            "explanationSource": "LinkedIn",
            "criteriaClassification": "Meets",
            "criteria": "Bachelor's or Master's Degree in Computer Science or related technical discipline, or related practical experience."
          }
        ],
        "requiredCriteriaCount": 1,
        "preferredCriteriaMatchCount": 1,
        "requiredCriteriaMatchCount": 1,
        "evaluatedAt": 1748454105,
        "requiredCriteriaExplanations": [
          {
            "explanationSource": "LinkedIn",
            "criteriaClassification": "Meets",
            "criteria": "2-5 years of experience in software engineering."
          }
        ],
        "preferredCriteriaCount": 1,
        "evaluationProfileUrl":"http://www.linkedin.com/profile/12345"
      },
      "jobRequisitionId": "03cd778e-7247-464b-b215-30b5b5e9e165",
      "integrationContext": "urn:li:organization:1234"
    }
  ]
}

Note

Be sure to check the response for error statuses corresponding to the exported evaluation.