Table of Contents
Get a single job from ATS linked account
Get all jobs from ATS linked account
API Key Management
- Only admins have the ability to generate/create the API key. This can be done from the organizational settings page in Findem.
- Currently there is a limit of 1 token/API key per account. (based on the allowlisting accounts on Findem production).
Endpoint:
- URL: “/hm/api/public_api_token”
- Method: [GET, POST, DELETE]
- Description: Use this api to create or delete the API key.
Get a single job from ATS linked account
- Use this API to get a job posting from the Findem DB
Endpoint
- URL: “/jobs/{job_id}”
- Method: [GET]
- Description: Use this API to fetch a single job posting (specific) from the ATS linked account.
- Parameters:
- Parameter 1: job_id (ID of a Job)
- Parameter 2: API_KEY
- Example Request:
curl -k --location 'https://api.findem.ai/pub_api/v1/ats/jobs/4989941003' \
--header 'Authorization: Api-Key API_KEY'
- Example Response:
{
"status": "success",
"jobs": [{
"ats_job_id": "ocuhufwb",
"job_created_ts": 1722977484448,
"postingType": "Limited Access",
"job_last_updated_ts": 1722981531640,
"job_location": {
"country": "United States",
"city": "Phoenix",
"state": "Arizona"
},
"job_name": "Systems Sales Engineer (Pre-Sales)",
"job_state": "open",
"last_sync_ts": 1722985529139,
"posting_details": {
"external_job_url": null,
"job_description": "
",
"additional_information": ""
},
"requisition_id": "27283"
}]
}
Get all jobs from ATS linked account
- Use this API to get all jobs from the ATS linked Findem account.
Endpoint
- URL: "/jobs"
- Method: [GET]
- Description: Use this API to get list of all jobs
- Parameters:
- Parameter 1: API_KEY
- Query Parameters (optional): created_after={epoch_ts}
- Supported Filters:
- The HappyDance API currently supports only two filters: job_id and created_after.
- No additional filters are available for fields like region, country, or requisition ID.
- Any further filtering must be handled on the client side after receiving the complete list of results.
- Example Request:
curl -k --location 'https://api.findem.ai/pub_api/v1/ats/jobs?created_after=1722973036814 \
--header 'Authorization: Api-Key KEY'
- Example Response:
{
"status": "success",
"jobs": [
{
"ats_job_id": "ocuhub",
"job_created_ts": 1722977484448,
"postingType": "Limited Access",
"job_last_updated_ts": 1722981531640,
"job_location": {
"country": "United States",
"city": "Phoenix",
"state": "Arizona"
},
"job_name": "Systems Sales Engineer (Pre-Sales)",
"job_state": "open",
"last_sync_ts": 1722985529139,
"posting_details": {
"external_job_url": null,
"job_description": "
",
"additional_information": ""
},
"requisition_id": "2728443"
},
{
"job_id": "oAshuf",
"job_created_ts": 1722974036814,
"postingType": "Limited Access",
"job_last_updated_ts": 1722981531640,
"job_location": {
"country": "United States",
"city": "Phoenix",
"state": "Arizona"
},
"job_name": "Systems Sales Engineer (Pre-Sales)",
"job_state": "open",
"last_sync_ts": 1722985529139,
"posting_details": {
"external_job_url": null,
"job_description": "
",
"additional_information": ""
},
"requisition_id": "2724483"
},
]
}
Comments
0 comments
Please sign in to leave a comment.