Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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:
|
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:
|
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.