Retrieve Recruiter Seatholders

A LinkedIn Recruiter seat contains a LinkedIn user who is licensed for specific roles within LinkedIn Recruiter. To utilize the Recruiter Prospect Interaction APIs, you will need the Recruiter Contract seatholder details in order to properly attribute the inMails and Prospect Notes to the end users in your application.

All API requests require authorization . Additionally, API requests return paged results; details on paging through results can be found here .

Note

Person URN should be used to match the ATS user to Recruiter seatholders. The ID returned in this call refers to the Seat ID, which is referenced in the other Recruiter Prospect Interaction API calls as a Seat URN (e.g. urn:li:seat:123456789).

Retrieve seatholders for a contract:

GET https://api.linkedin.com/v2/seats?q=seatsByAttributes

Query parameters

Field Description Format Required Notes
contracts The Recruiter contract ID(s) Contract URN in format urn:li:contract:{id} Yes Find seatholders associated with specific contract(s). Multiple allowed.
active The status of the seatholder Boolean No Find active seatholders

sample request

GET https://api.linkedin.com/v2/seats?q=seatsByAttributes&contracts=urn:li:contract:123456789&start=0&count=5

sample response

{
    "elements": [
        {
            "firstName": "testFirst1",
            "lastName": "testLast1",
            "contractId": "urn:li:contract:123456789",
            "member": "urn:li:person:a1b2c3d4",
            "active": true,
            "admin": false,
            "id": 142636035,
            "email": "test1@linkedin.com"
        },
        {
            "firstName": "testFirst2",
            "lastName": "testLast2",
            "contractId": "urn:li:contract:123456789",
            "member": "urn:li:person:a2b3c4d5",
            "active": true,
            "admin": false,
            "id": 142636055,
            "email": "test2@linkedin.com"
        },
        {
            "firstName": "testFirst3",
            "lastName": "testLast3",
            "contractId": "urn:li:contract:123456789",
            "member": "urn:li:person:a3b4c5d6",
            "active": false,
            "admin": false,
            "id": 142636075,
            "email": "test3@linkedin.com"
        },
        {
            "firstName": "testFirst4",
            "lastName": "testLast4",
            "contractId": "urn:li:contract:123456789",
            "member": "urn:li:person:a4b5c6d7",
            "active": false,
            "admin": false,
            "id": 142636095,
            "email": "test4@linkedin.com"
        },
        {
            "firstName": "testFirst5",
            "lastName": "testLast5",
            "contractId": "urn:li:contract:123456789",
            "member": "urn:li:person:a5b7c9d0",
            "active": false,
            "admin": false,
            "id": 142636105,
            "email": "test5@linkedin.com"
        }
    ],
    "paging": {
        "total": 10,
        "count": 5,
        "start": 0,
        "links": [
            {
                "rel": "next",
                "href": "/v2/seats?contracts=urn%3Ali%3Acontract%3A123456789&count=5&q=seatsByAttributes&start=5",
                "type": "application/json"
            }
}