ATS Application Orderings

Fetch Orderings

Whenever a list of job application ordering data is needed, make a call to fetch the ordering data. Pagination is supported via this API.

Use the following endpoint to get orderings:

GET https://api.linkedin.com/v2/atsApplicationOrderings?q=criteria&integrationContext={organization URN}&atsJobPostingId={your job posting Id}

Request Parameters

Parameter Description Required
integrationContext  Integration context value for the customer's LINKEDIN_MATCH integration type. You'll get this value when the customer enables the integration via the Integration Configuration Plugin.  Yes 
atsJobPostingId  Specify job posting Id in your system. This will be used to find applications in your system to order. This will also be used to find LinkedIn job posting to match candidates.  Yes 

Response Parameters

Parameter Description Format Required
atsApplicationId    Application's unique identifier in your ATS.  String  Yes 
integrationContext   Integration context supplied in the request.  String  Yes 
dataProvider  Data provider always being "ATS".  String  Yes 
ordering  It specifies the ordering of an application for the LinkedIn job posting. It is an integer number and the first application's ordering is 1. The range is [1, N] where N represents the number of total applications for this job. It is possible that there are more than one applications have the same ordering.  Integer  Yes 

Sample Response

A successful request will return a 200 OK response code.

sample response body

{
    "elements": [
        {
            "atsApplicationId": "APPL456",
            "dataProvider": "ATS",
            "integrationContext": "urn:li:organization:2414183",
            "ordering": 1
        },
        {
            "atsApplicationId": "APPL123",
            "dataProvider": "ATS",
            "integrationContext": "urn:li:organization:2414183",
            "ordering": 2
        },
        {
            "atsApplicationId": "APPL633",
            "dataProvider": "ATS",
            "integrationContext": "urn:li:organization:2414183",
            "ordering": 3
        }
    ],
    "paging": {
        "count": 10,
        "start": 0,
        "total": 3
    }
}