Check Job Posting Statuses

After jobs have successfully posted on LinkedIn a jobs' status can change at a later time. Some examples are jobs converting from an on-site to off-site application flow, jobs being reported by members resulting in that job being closed. With those changes partners do not have visibility into these changes as they happen, and have no way to retrieve the current status of a job posting on LinkedIn. This limitation also prevents ATS partners from having a way to display accurate job status information to customers in their UI.

With the Job Posting Status API partners will be able to retrieve up-to-date statuses of their customer posted jobs.

Optionally, we've introduced a Job Status Change Notifications API. This allows partners to be notified by LinkedIn in near real-time of up-to-date statuses of their customer posted jobs.

Requirements

• Periodically check the status of customer synced jobs at regular intervals to ensure your application has up-to-date job posting statuses.
• Display, at minimum jobPostingUrl, listingStatus, linkedInApplyStatus, promotionStatus on all job postings synced to LinkedIn.
• Ensure your LinkedIn API requests comply with the following size requirements below. If your request exceeds the size requirements your request will receive a 414 response.

Authentication

All requests below require access tokens obtained via the OAuth 2 Client Credentials flow.

Throttle Limits

Job Posting Status Request

API Endpoint

GET https://api.linkedin.com/v2/jobPostingStatus?ids={externalJobPostingId_1}&ids={externalJobPostingId_2}

Sample Request

curl --location --request GET 'https://api.linkedin.com/v2/jobPostingStatus?ids={external_job_posting_id_1}&ids={external_job_posting_id_2}' \
--header 'Authorization: Bearer {access_token}' \

Sample Request with Query Tunneling

curl --location --request POST 'https://api.linkedin.com/v2/jobPostingStatus' \
--header 'X-HTTP-Method-Override: GET' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer {access_token}' \
--data-urlencode 'ids={external_job_posting_id_1}' \
--data-urlencode 'ids={external_job_posting_id_2}'

Sample Response Body of jobs without alternateLocations

{
    "results": {
        "job-1234": {
            "jobPostingUrl": "https://www.linkedin.com/jobs/view/12345678",
            "partnerJobCampaign": "374823",
            "promotionStatusDetail": {
                "errorCode": 1054,
                "errorType": "CUSTOMER_ERROR",
                "statusMessage": "Reach out to LinkedIn Sales (https://business.linkedin.com/talent-solutions/contact-us) to learn more."
            },
            "jobCampaign": "urn:li:jobCampaign:12844",
            "listingStatus": "LISTED",
            "rawLocation": "Enterprise, UT",
            "externalJobPostingId": "job-1234",
            "linkedInApplyStatus": "ENABLED",
            "jobPostingInfo": {
                "location": "Enterprise, Utah, United States",
                "companyDetails": {
                    "companyPage": "https://www.linkedin.com/company/1234567890",
                    "companyName": "Test Company"
                },
                "expireAt": 1710615358000,
                "listedAt": 1694015408000
            },
            "promotionStatus": "NOT_PROMOTED"
        },
        "job-2345": {
            "listingStatus": "NOT_LISTED",
            "externalJobPostingId": "job-2345",
            "listingStatusDetail": {
                "errorCode": 1050,
                "errorType": "PARTNER_ERROR",
                "statusMessage": "The job was not found. Please ensure the job was sent to LinkedIn"
            }
        }
    },
    "statuses": {},
    "errors": {}
}

Sample Response Body of jobs with alternateLocations

For each location a job object will be returned with the details and statuses.

{
  "statuses": {},
  "results": {
    "job-1234~~1f3a599": {
      "linkedInApplyStatusDetail": {
        "statusMessage": "No attempt to enable LinkedInApply was found for this job.",
        "errorType": "PARTNER_ERROR"
      },
      "jobPostingUrl": "https://www.linkedin.com/jobs/view/12345678",
      "listingStatus": "LISTED",
      "rawLocation": "Enterprise, UT",
      "externalJobPostingId": "job-12345",
      "linkedInApplyStatus": "NOT_ENABLED",
      "developerApplicationUrn": "urn:li:developerApplication:12345678",
      "jobPostingInfo": {
        "companyDetails": {
          "companyPage": "https://www.linkedin.com/company/1234567890",
          "companyName": "Test Company"
        },
        "location": "Enterprise, Utah, United States",
        "listedAt": 1706819177000,
        "expireAt": 1724531132000
      },
      "promotionStatus": "NOT_PROMOTED"
    },
    "job-1234~~a678450": {
      "linkedInApplyStatusDetail": {
        "statusMessage": "No attempt to enable LinkedInApply was found for this job.",
        "errorType": "PARTNER_ERROR"
      },
      "partnerJobCampaign": "374823",
      "jobPostingUrl": "https://www.linkedin.com/jobs/view/012345678",
      "jobCampaign": "urn:li:jobCampaign:12844",
      "listingStatus": "LISTED",
      "rawLocation": "San Francisco, CA",
      "externalJobPostingId": "job-12345",
      "linkedInApplyStatus": "NOT_ENABLED",
      "developerApplicationUrn": "urn:li:developerApplication:12345678",
      "jobPostingInfo": {
        "companyDetails": {
          "companyPage": "https://www.linkedin.com/company/1234567890",
          "companyName": "Test Company"
        },
        "location": "San Francisco, California, United States",
        "listedAt": 1706819177000,
        "expireAt": 1724531132000
      },
      "promotionStatus": "NOT_PROMOTED"
    }
  },
  "errors": {}
}

Job Posting Status Field Schema

JobPostingInfo Field Schema

CompanyDetails Field Schema

JobVisibility Enums

JobPostingStatusDetail Field Schema

ListingStatusDetails Error Codes

LinkedinApplyStatus Error Codes

PromotionStatus Error Codes