Page Comparison

These are the endpoints that are available under the /job and /jobRequisition paths, which allows you to view or modify the jobs and job requisitions on your business' account.

Endpoint	Description
GET /job	Returns all job objects on an account in array format.
GET /job/tags	Returns all tags for a job in array format.
POST /job	Creates a new job object on your business' account. Request body/payload: Must pass a job object in the request body/payload. For these calls, you need to pass a job object with all required fields and any fields you want to set filled in the body of the payload. We have an example of a job object in the responses section below and have indicated the required fields in the object values table at the bottom of this page.
PUT /job	Updates an existing job object on your business' account - object must include jobId property fill in with the jobRequisitionId value of the job object you want to update. Request body/payload: Must pass a job object in the request body/payload. For these calls, you need to pass a job object with all required fields and any fields you want to update filled in the body of the payload. We have an example of a job object in the responses section below and have indicated the required fields in the object values table at the bottom of this page.
DELETE /job/{jobId}	Removes specified job object from view by setting its active property to false.
GET /jobRequisition	Returns all jobRequisition objects on an account in array format.
GET /jobRequisition/job/{jobId}	Returns a JSON object for specified job requisition.
GET /jobRequisition/requisitionNumber/{requisitionNumber}	Returns an active jobRequisition object on account that matches the requisitionNumber passed in URL - can be used to make sure that no duplicate jobRequisition numbers are added to your account.
POST /jobRequisition	Creates a new jobRequisition object on your business' account. Request body/payload: Must pass a jobRequisition object in the request body/payload. For these calls, you need to pass a jobRequisition object with all required fields and any fields you want to set filled in the body of the payload. We have an example of a jobRequisition object in the responses section below and have indicated the required fields in the object values table at the bottom of this page.
PUT /jobRequisition	Updates an existing jobRequisition object on your business' account. Request body/payload: Must pass a jobRequisition object in the request body/payload. For these calls, you need to pass a jobRequisition object with all required fields and any fields you want to update filled in the body of the payload. We have an example of a jobRequisition object in the responses section below and have indicated the required fields in the object values table at the bottom of this page
DELETE /jobRequisition/{jobRequisitionId}	Removes specified jobRequisition object from view by setting its active property to false.

There are no parameters associated with schedulerPreference calls.

Code BlocklanguagejstitleGET

The objects below represent the minimum viable objects to pass that are needed to create or update a job or jobRequisition object. Check whether or not a property can be written to by looking at the Object Values table below to see if the property is writable.

Code Block

language	jfx
title	POST /job
linenumbers	true
collapse	true

[{
    "active": true,
    "businessIdjobRequisitions": 43111, [{
        "createdDateactive": 1540478732320true,
      "createdUser  "businessId": "JoeSchmo"43111,
        "jobIdduplicate": 50049false,
        "jobTitleduplicateJobTitle": "Dog Trainer",
        "modifiedDateduplicateReqId": 1542316658941140994,
        "modifiedUserrequisitionNumber": "JoeSchmo7",
        "tagsstatus": ["OPEN"
    }],
    "0jobTitle": "dogsCrab Fiddler",
    "tags":    "1": "trainers"
]}]null
}

Code Block

language	js
title	GET PUT /job/tags
linenumbers	true
collapse	true

[{
    "0active": "dogs"true,
    "1businessId": "trainers"
]

Code Block

language	js
title	POST /job
linenumbers	true
collapse	true

{
43111,
    "activecreatedDate": true1543338540650,
    "businessIdcreatedUser": 43111"JoeSchmo",
    "createdDateexpanded": 1543338015786true,
    "createdUserjobId": "JoeSchmo",57804,
    "jobRequisitions": [{
        "jobIdactive": 57771true,
        "jobTitlebusinessId": "Cat Groomer",43111,
        "modifiedDateduplicate": nullfalse,
        "modifiedUserduplicateJobTitle": null,"",
        "tagsrequisitionNumber": null
}

Code Block

language	js
title	PUT /job
linenumbers	true
collapse	true

{"3",
        "activestatus": true,"OPEN"
    "businessId": 43111}],
    "createdDatejobTitle": 1543338015786"Cat Wrangler",
    "createdUserjobTitleTranslationCode": "JoeSchmotag.job.req_jobtitle.57804",
    "jobIdmodifiedDate": 577711548186839575,
    "jobTitlemodifiedUser": "Cat Groomer",
    "modifiedDate": 1543344683572,
    "modifiedUser": "JoeSchmo",
    "tags": []null
}

Code Block

language	js
title	GET POST /jobRequisition
linenumbers	true
collapse	true

[{
    "active": true,
    "businessId": 43111,
    "createdDateduplicate": 1540478732435false,
    "createdUserduplicateJobTitle": "JoeSchmo",
    "departmentjob": null,{
        "divisionactive": nulltrue,
 
  "employmentDurationType": null,     "employmentTermTypebusinessId": null43111,
    "job": {
        "active": true,
        "businessId": 43111,
        "    "createdDate": 15404787323201550091322769,
        "createdUser": "JoeSchmo",
        "jobId": 5004967044,
        "jobTitle": "DogCertified Fox Trainer",
        "modifiedDate": 1542316658941null,
        "modifiedUser": "MORGANKEARNEY"null,
        "tags": [null
       },
    "0requisitionNumber": "dogs7",
    "status":   "OPEN"
}

Code Block

language	js
title	PUT /jobRequisition
linenumbers	true
collapse	true

{
    "1active": "trainers"true,
    ]}]"businessId": 43111,
    "jobRequisitionIdcreatedDate": 546071543338540740,
    "locationNamecreatedUser": null"JoeSchmo",
    "managerNamedepartment": null,
    "modifiedDatedivision": 1542316659018null,
    "modifiedUserediting": "JoeSchmo"true,
    "requisitionNumberemploymentDurationType": "12"null,
    "statusemploymentTermType": null,
    "OPENjob"
}]

Code Block

language	js
title	GET /jobRequisition/job/{jobId}
linenumbers	true
collapse	true

[{: {
        "active": true,
        "businessId": 43111,
        "createdDate": 15433385407401543338540650,
        "createdUser": "JoeSchmo",
    "department": null,     "divisionjobId": null57804,
 
  "employmentDurationType": null,     "employmentTermTypejobTitle": null,
    "job": {"Cat Wrangler",
         "activemodifiedDate": true1550092503196,
        "businessIdmodifiedUser": 43111"JoeSchmo",
        "createdDatetags": null
1543338540650,    },
    "createdUserjobRequisitionId": "JoeSchmo"62883,
        "jobId""locationName": 57969null,

       "jobTitlemanagerName": "Dog Comber"null,
        "modifiedDate": null1550092503242,
        "modifiedUser": null"JoeSchmo",
        "tagsoriginalNumber": null
    }"1",
    "jobRequisitionIdrequisitionNumber": 63048"12",
    "locationNamesaving": nulltrue,
    "managerNamestatus": null,
"OPEN"
}

Code Block

language	js
title	GET /job
linenumbers	true
collapse	true

[{
    "modifiedDateactive": 1543338638797true,
    "modifiedUserbusinessId": "JoeSchmo"43111,
    "createdDate": 1540478732320,
    "requisitionNumbercreatedUser": "2JoeSchmo",
    "jobId"status:" "OPEN"
}]

Code Block

language	js
title	POST /jobRequisition
linenumbers	true
collapse	true

{
 50049,
     "activejobTitle": true,
    "businessId": 43111"Dog Trainer",
    "createdDatemodifiedDate": 15433385407401542316658941,
    "createdUsermodifiedUser": "JoeSchmo",
    "departmenttags": null,
 [
  "division": null,     "employmentDurationType0": null"dogs",
    "employmentTermType": null    "1": "trainers"
]}]

Code Block

language	js
title	GET /job/tags
linenumbers	true
collapse	true

[
    "0": "dogs",
    "1": "trainers"
]

Code Block

language	js
title	POST /job
linenumbers	true
collapse	true

{
    "active": true,
    "businessId": 43111,
    "createdDate": 1543338015786,
    "createdUser": "JoeSchmo",
    "jobId": 57771,
    "jobTitle": "Cat Groomer",
    "jobmodifiedDate": {null,
    "modifiedUser": null,
    "activetags": true,
  null
}

Code Block

language	js
title	PUT /job
linenumbers	true
collapse	true

{
    "active": true,
     "businessId": 43111,
        "createdDate": 15433385406501543338015786,
        "createdUser": "JoeSchmo",
   
    "jobId": 5780457771,
        "jobTitle": "Cat WranglerGroomer",
        "modifiedDate": null1543344683572,
 
      "modifiedUser": null"JoeSchmo",
        "tags": null
 []
}

Code Block

language	js
title	GET /jobRequisition
linenumbers	true
collapse	true

[{
  },
    "jobRequisitionIdactive": 62883true,
    "locationNamebusinessId": null43111,
    "managerNamecreatedDate": null1540478732435,
    "modifiedDatecreatedUser": null,     "modifiedUserJoeSchmo": null,
    "requisitionNumberdepartment": "6"null,
    "statusdivision": "OPEN"
}

Code Block

language	js
title	PUT /jobRequisition
linenumbers	true
collapse	true

{null,
    "activeemploymentDurationType": truenull,
    "businessIdemploymentTermType": 43111null,
    "createdDatejob": 1543338016070, {
        "createdUseractive": "JoeSchmo",true,
        "departmentbusinessId": null43111,
        "divisioncreatedDate": null1540478732320,
        "employmentDurationTypecreatedUser": null,"JoeSchmo",
        "employmentTermType": null,jobId": 50049,
        "jobjobTitle": {"Dog Trainer",
        "activemodifiedDate": true1542316658941,
        "businessIdmodifiedUser": 43111"MORGANKEARNEY",
        "createdDatetags": 1543338015786, [
            "createdUser0": "JoeSchmodogs",
            "jobId1": 57804,"trainers"
    ]}],
    "jobTitlejobRequisitionId": 54607,
    "Cat Wrangler",
 locationName": null,
      "modifiedDatemanagerName": null,
    "modifiedDate": 1542316659018,
    "modifiedUser": null"JoeSchmo",
    "requisitionNumber": "12",
    "tagsstatus": null
    },"OPEN"
}]

Code Block

language	js
title	GET /jobRequisition/job/{jobId}
linenumbers	true
collapse	true

[{
    "jobRequisitionIdactive": 62883true,
    "locationNamebusinessId": null43111,
    "managerNamecreatedDate": null1543338540740,
    "modifiedDatecreatedUser": null"JoeSchmo",
    "modifiedUserdepartment": null,
    "requisitionNumberdivision": "3"null,
    "status": "OPEN"
}

Code Block

language	jfx
title	POST /job
linenumbers	true
collapse	true

{employmentDurationType": null,
    "activeemploymentTermType": truenull,
    "jobRequisitionsjob": [{
        "active": true,
        "businessId": 43111,
        "duplicatecreatedDate": false1543338540650,
        "duplicateJobTitlecreatedUser": "JoeSchmo",
        "requisitionNumber"jobId": 57969,
        "jobTitle": "7Dog Comber",
        "statusmodifiedDate": null,
"OPEN"
        "modifiedUser": null,
   }],     "jobTitletags": "Certified Fox Trainer"null
    },
    "tagsjobRequisitionId": null
}

Code Block

language	js
title	PUT /job
linenumbers	true
collapse	true

{
63048,
    "activelocationName": truenull,
    "businessIdmanagerName": 43111null,
    "createdDatemodifiedDate": 15433385406501543338638797,
    "createdUsermodifiedUser": "JoeSchmo",
    "jobIdrequisitionNumber": 57804"2",
    "status:" "jobRequisitionsOPEN": [
}]

Code Block

language	js
title	POST /jobRequisition
linenumbers	true
collapse	true

{
        "active": true,
  
     "businessId": 43111,
        "createdDate": 1543338540740,
        "createdUser": "JoeSchmo",
        "department": null,
   
    ""division": null,
        "employmentDurationType": null,
   
    "employmentTermType": null,
   
    "job": {
  {
         "active": true,
            "businessId": 43111,
 
          "createdDate": 1543338540650,
   
        "createdUser": "JoeSchmo",
   
        "jobId": 57804,
            "jobTitle": "Cat WranglersWrangler",
        "modifiedDate": null,
        "modifiedDatemodifiedUser": 1548186839575null,
         "tags": null
    },
    "jobRequisitionId": 62883,
    "modifiedUserlocationName": "JoeSchmo"null,
       "managerName": null,
    "tagsmodifiedDate": null,
    "modifiedUser": null,
  },  "requisitionNumber": "6",
     "jobRequisitionIdstatus": 62883,
   "OPEN"
}

Code Block

language	js
title	PUT /jobRequisition
linenumbers	true
collapse	true

{
    "locationNameactive": nulltrue,
        "managerNamebusinessId": null43111,
   
    "modifiedDatecreatedDate": 15481868396111543338016070,
        "modifiedUsercreatedUser": "JoeSchmo",
   
    "requisitionNumberdepartment": "1"null,
        "status": "OPEN",
    },
    "jobTitle": "Cat Wrangler""division": null,
    "modifiedDateemploymentDurationType": 1548186839575null,
    "modifiedUseremploymentTermType": "JoeSchmo"null,
    "tagsjob": {
null
}

Code Block

language	js
title	POST /jobRequisition
linenumbers	true
collapse	true

{        "active": true,
        "businessId": 43111,
        "jobcreatedDate": {1543338015786,
        "activecreatedUser": true"JoeSchmo",
        "businessIdjobId": 4311157804,
        "createdDatejobTitle": 1550091322769"Cat Wrangler",
        "createdUsermodifiedDate": "MORGANKEARNEY"null,
        "jobIdmodifiedUser": 67044null,
        "jobTitletags": "Certifiednull
Fox Trainer",    },
    "modifiedDatejobRequisitionId": null62883,
    "locationName": null,
    "modifiedUsermanagerName": null,
   
    "tagsmodifiedDate": null,
    "modifiedUser": }null,
    "requisitionNumber": "73",
    "status": "OPEN"
}

job

Property name	Type	Required	Description
active	boolean	Yes	Indicates whether or not the specified job should return on GET calls.
businessId	integer	Yes	Provides unique numeric ID for the business to which specified job belongs.
createdDate	integer		Displays as the date the specified job was created in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
createdUser	string		Displays the username of user who created the specified job.
jobId	integer	Yes, on PUT calls	Provides unique numeric ID for the specified job.
jobTitle	stringYes	Yes	Displays as the title of the specified job.
modifiedDate	integer		Displays as the date the specified job was last modified in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
modifiedUser	string		Displays the username of user who last modified the specified job.
tags	arrayYes		Displays as an array of string tags provided for the specified job.

jobRequisition

Name	Type	Required	Description
active	boolean	Yes	Indicates whether or not the specified job requisition should return on GET calls.
businessId	integer	Yes	Provides unique numeric ID for the business to which the specified job belongs.
createdDate	integer		Displays as the date the specified job requisition was created in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
createdUser	string		Displays the username of user who created the specified job requisition.
department	string		Not set up yet - displays as what is set as the department for the specified job requisition.
division	string		Not set up yet - displays as what is set as the division for the specified job requisition.
employmentDurationType	string		Not set up yet - displays as the duration type of employment for the specified job requisition.
employmentTermType	string		Not set up yet - displays as the term type of employment for the specified job requisition.
job	object		Displays the job object for job of the specified job requisition.
jobRequisitionId	integer	Yes, on PUT calls7calls	Provides unique numeric ID for specified job requisition.
locationName	string		Not set up yet - displays as what is set as the location name for specified job requisition.
managerName	strings		Not set up yet - displays as what is set as the manager name for specified job requisition.
modifiedDate	integer		Displays as the date specified job requisition was last modified in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
modifiedUser	string		Displays the username of user who last modified specified job requisition.
requisitionNumber	string	Yes	Displays as the requisition number given to specified job requisition.
status	string	Yes	Displays as the status of specified job requisition. Has acceptable values "OPEN",

Version	Old Version 42	New Version Current
Changes made by	Joel Kearney	Joel Kearney
Saved on	Mar 04, 2019	Aug 07, 2023

Versions Compared

Key

Job and Job Requisition API Endpoints

Job and Job Requisition API Parameters

Job and Job Requisition

Request Body/Payloads

Job and Job Requisition API Responses

Job and Requisition Request Body/Payloads

Job and Requisition Object Values

job

jobRequisition