How to Retrieve Candidate Previous Employment / Work History via API

Posted by HimanshuP on in Standard Integration Questions

I have reviewed the available iCIMS API documentation but have not been able to identify:

  • A dedicated endpoint for Previous Employment

  • Whether this data exists as a standard object

Can someone from iCIMS or the community clarify:

  1. Does iCIMS expose structured work history data via API?

  2. If so, which endpoint(s) or fields should I query?

  3. If not exposed by default, is this something that must be enabled or mapped by iCIMS Support?

  4. Are there recommended best practices for pulling this information into third-party systems like Salesforce?

Thanks in advance for any guidance.

Submitted by JonB on November 19, 2025 Permalink

Yes, the work history is structured and exposed via API in the "workexperience" field group. You can see the fields included on the Person Profile Data Model Page - https://developer-community.icims.com/applications/applicant-tracking/ats-data-models/person-profile. Review the fields under workexperience near the bottom of the table. 

You will query the people endpoint to get the data. For example, https://api.icims.com/customers/<customerID>/people/<personSystemID>?fields=workexperience, will return the details of their work history.