AlliedTravelCareers API v2.0

Jobs

JSON XML

The jobs resource is used to manage job data from AlliedTravelCareers.

The job object

The job object represents a job posting for your account.

Attributes

referenceNumber


            string

Can be any combination of letters and numbers. Must be unique for each job.

This number is used to identify if our website already has a copy of this job. If it exists, we will update the existing job with any new information provided. If not, the job will be added as a new job.

title


            string

The title of your job posting.

city


            string

The city where your job posting is located.

state


            string

The state where your job posting is located.

postalCode


            string

The ZIP code where your job posting is located.

license


            enum

What type of license a provider applying to your job post needs to have. We use this to appropriately categorize your job.

Possible enum values:

Anesthesia Technician
Audiologist
BCBA - School
Behavioral Health Tech
Behavioral Therapist
Cardiovascular Tech
Cath Lab Tech
Certified Occupational Therapist Assistant (COTA)
CLS
CRT
CST
CT Tech
CVOR Tech
Cytotech / Cytogenetics
Dental Assistant
Dental Hygienist
Dialysis Tech
Dietician / Registered Dietician
DOR
Dosimetrist
Dual-Modality Tech
Echo Tech

EEG Tech
EKG Tech
Electrophysiology Tech
EMT
Endo Tech / GI Tech
HBOT
Histo Tech
Interventional Radiology
LAC
Licensed Clinical Social Worker
Licensed Professional Marriage Counselor
LISAC
LMSW
LPC
LPCC
LSW
Mammography Tech
Medical Assistant
Medical Lab Technician
Medical Social Worker
Medical Technologist
Microbiology Tech

Monitor Tech
MRI Tech
Neurodiagnostic Tech
Neurophysiology Tech
Non-Clinical Tech
Nuclear Medicine Tech
OB Tech
Occupational Therapist (OT)
Ophthalmic Technician
Orthopedic Tech
OT - School
OTA
OTA - School
Paramedic
Pathology Assistant
Patient Care Tech
Perfusionist
Pharmacist
Pharmacy Tech
Phlebotomist
Physical Therapist (PT)
Physical Therapy Assistant (PTA)

Polysomnographic / Sleep Tech
Psych Tech
Psychologist - School
Psychology
PT - School
Rad Tech
Radiation Therapist
Recreational Therapist
Resp Tech
RRT
SFA
SLP - School
SLPA
SLPA - School
Special Procedures Tech
Sped Teacher
Speech Language Pathologist (SLP)
Sterile Processing Tech
Surg Tech
Technician
Tele Tech
Ultrasound

Vascular Tech
X-Ray Tech

shift


            string

Map a client’s shift field to this field if the full shift info is stored in one field

shiftType


            enum

The type of shifts the employee is expected to work.

Possible enum values:

days
nights
evenings
rotating

shiftsPerWeek


            integer

The number of shifts per week the employee is expected to work. Values from 3 - 6

hoursPerShift


            integer

The number of hours per shift the employee is expected to work. Values from 6 - 16

payAmountMin


            decimal

The minimum pay provided by the Client for this Job. This is the bottom end of the pay range.

payAmountMax


            decimal

The maximum pay provided by the Client for this Job. This is the top end of the pay range.

payFrequency


            enum

The frequency at which a Client pays the Employee for this Job.

Possible enum values:

Hourly
Weekly

employmentType


            list<enum>

The type(s) of employment applicable for this job. You can include more than one value from the list of allowed values. See sample feed above for List format example when including multiple values.

Possible enum values:

Full-Time
Part-Time
Temporary
Permanent

durationLength


            integer

The numeric length part of the contract duration (e.g. the "13" in "13 weeks").

durationUnit


            enum

The unit part of the contract duration (e.g. the "weeks" in "13 weeks").

Possible enum values:

day
week
month
year

startDate


            date

The date your position starts. If left blank, or a date in the past, the start date will automatically be set to ASAP.

description


            string

The description of your job posting. Basic HTML tags are allowed. If using XML, wrap in <![CDATA[ ]]>

requirements


            string

The minimum requirements a lead applying to your job posting must meet. Basic HTML tags are allowed. If using XML, wrap in <![CDATA[ ]]>

benefits


            string

The benefits offered by this position. Basic HTML tags are allowed.

Example

{
    "id": 4,
    "title": "Job Title",
    "license": "PT",
    "city": "Lancaster",
    "state": "PA",
    "zip": "17603",
    "shift": "Flex",
    "shiftType": "evenings",
    "shiftsPerWeek": 5,
    "hoursPerShift": 8,
    "payAmountMin": "1980.00",
    "payAmountMax": "2420.00",
    "payFrequency": "Weekly",
    "durationLength": 25,
    "durationUnit": "week",
    "startdate": "2025-11-05",
    "description": "Job Description",
    "requirements": "Job Requirements",
    "benefits": "Text describing the benefits for the position",
    "posted": "2025-11-05",
    "referenceNumber": "TFoVVjnM",
    "employmentType": "Full-Time"
}

<?xml version="1.0"?>
<jobs>
  <job>
    <id>4</id>
    <title>Job Title</title>
    <license>PT</license>
    <city>Lancaster</city>
    <state>PA</state>
    <zip>17603</zip>
    <shift>Flex</shift>
    <shiftType>evenings</shiftType>
    <shiftsPerWeek>5</shiftsPerWeek>
    <hoursPerShift>8</hoursPerShift>
    <payAmountMin>1980.00</payAmountMin>
    <payAmountMax>2420.00</payAmountMax>
    <payFrequency>Weekly</payFrequency>
    <durationLength>25</durationLength>
    <durationUnit>week</durationUnit>
    <startdate>2025-11-05</startdate>
    <description>Job Description</description>
    <requirements>Job Requirements</requirements>
    <benefits>Text describing the benefits for the position</benefits>
    <posted>2025-11-05</posted>
    <referenceNumber>TFoVVjnM</referenceNumber>
    <employmentType>Full-Time</employmentType>
  </job>
</jobs>

List all jobs

GET https://www.alliedtravelcareers.com/api/v2.0/jobs.json GET https://www.alliedtravelcareers.com/api/v2.0/jobs.xml

URL Parameters

No parameters.

Query Parameters

No parameters.

Example Request

GET https://www.alliedtravelcareers.com/api/v2.0/jobs.json GET https://www.alliedtravelcareers.com/api/v2.0/jobs.xml

Example Response

[
    {
        "id": 5,
        "title": "Job Title",
        "license": "PTA",
        "city": "Lancaster",
        "state": "PA",
        "zip": "17603",
        "shift": "Flex",
        "shiftType": "evenings",
        "shiftsPerWeek": 5,
        "hoursPerShift": 8,
        "payAmountMin": "1980.00",
        "payAmountMax": "2420.00",
        "payFrequency": "Weekly",
        "durationLength": 25,
        "durationUnit": "week",
        "startdate": "2025-11-05",
        "description": "Job Description",
        "requirements": "Job Requirements",
        "benefits": "Text describing the benefits for the position",
        "posted": "2025-11-05",
        "referenceNumber": "TFoVVjnM",
        "employmentType": "Full-Time"
    },
    {
        "id": 6,
        "title": "Job Title",
        "license": "PTA",
        "city": "Lancaster",
        "state": "PA",
        "zip": "17603",
        "shift": "Flex",
        "shiftType": "evenings",
        "shiftsPerWeek": 5,
        "hoursPerShift": 8,
        "payAmountMin": "1980.00",
        "payAmountMax": "2420.00",
        "payFrequency": "Weekly",
        "durationLength": 25,
        "durationUnit": "week",
        "startdate": "2025-11-05",
        "description": "Job Description",
        "requirements": "Job Requirements",
        "benefits": "Text describing the benefits for the position",
        "posted": "2025-11-05",
        "referenceNumber": "TFoVVjnM",
        "employmentType": "Part-Time"
    }
]

<?xml version="1.0"?>
<jobs>
  <job>
    <id>6</id>
    <title>Job Title</title>
    <license>OT</license>
    <city>Lancaster</city>
    <state>PA</state>
    <zip>17603</zip>
    <shift>Flex</shift>
    <shiftType>evenings</shiftType>
    <shiftsPerWeek>5</shiftsPerWeek>
    <hoursPerShift>8</hoursPerShift>
    <payAmountMin>1980.00</payAmountMin>
    <payAmountMax>2420.00</payAmountMax>
    <payFrequency>Weekly</payFrequency>
    <durationLength>25</durationLength>
    <durationUnit>week</durationUnit>
    <startdate>2025-11-05</startdate>
    <description>Job Description</description>
    <requirements>Job Requirements</requirements>
    <benefits>Text describing the benefits for the position</benefits>
    <posted>2025-11-05</posted>
    <referenceNumber>TFoVVjnM</referenceNumber>
    <employmentType>Full-Time</employmentType>
  </job>
  <job>
    <id>2</id>
    <title>Job Title</title>
    <license>PTA</license>
    <city>Lancaster</city>
    <state>PA</state>
    <zip>17603</zip>
    <shift>Flex</shift>
    <shiftType>evenings</shiftType>
    <shiftsPerWeek>5</shiftsPerWeek>
    <hoursPerShift>8</hoursPerShift>
    <payAmountMin>1980.00</payAmountMin>
    <payAmountMax>2420.00</payAmountMax>
    <payFrequency>Weekly</payFrequency>
    <durationLength>25</durationLength>
    <durationUnit>week</durationUnit>
    <startdate>2025-11-05</startdate>
    <description>Job Description</description>
    <requirements>Job Requirements</requirements>
    <benefits>Text describing the benefits for the position</benefits>
    <posted>2025-11-05</posted>
    <referenceNumber>TFoVVjnM</referenceNumber>
    <employmentType>Full-Time</employmentType>
  </job>
</jobs>

Post job(s)

POST https://www.alliedtravelcareers.com/api/v2.0/jobs.json POST https://www.alliedtravelcareers.com/api/v2.0/jobs.xml

Parameters

The maximum data payload size for requests to this endpoint is 1,000.

The maximum active jobs allowed is 10,000. Any additional jobs will be ignored.

This endpoint allows a maximum of 1 request per hour. Although single job postings are supported, it is intended that you post all jobs that you need to update on the site at one time (up to the maximum of 1,000 jobs), not one job at a time. If you need to post more than 1,000 jobs, you will need to spread this out over multiple requests, or alternatively, consider using the dedicated job import endpoint or configuring a job feed.

Field	Format/Values	Required	Description
referenceNumber	Alphanumeric	Yes	Can be any combination of letters and numbers. Must be unique for each job. This number is used to identify if our website already has a copy of this job. If it exists, we will update the existing job with any new information provided. If not, the job will be added as a new job.
title	String	Yes	The title of your job posting.
city	String	No	The city where your job posting is located.
state	USPS 2-letter abbreviation	Yes	The state where your job posting is located.
postalCode	USPS 5-digit or 9-digit ZIP code	No	The ZIP code where your job posting is located.
license	String One of the following allowed values: Anesthesia Technician Audiologist BCBA - School Behavioral Health Tech Behavioral Therapist Cardiovascular Tech Cath Lab Tech Certified Occupational Therapist Assistant (COTA) CLS CRT CST CT Tech CVOR Tech Cytotech / Cytogenetics Dental Assistant Dental Hygienist Dialysis Tech Dietician / Registered Dietician DOR Dosimetrist Dual-Modality Tech Echo Tech EEG Tech EKG Tech Electrophysiology Tech EMT Endo Tech / GI Tech HBOT Histo Tech Interventional Radiology LAC Licensed Clinical Social Worker Licensed Professional Marriage Counselor LISAC LMSW LPC LPCC LSW Mammography Tech Medical Assistant Medical Lab Technician Medical Social Worker Medical Technologist Microbiology Tech Monitor Tech MRI Tech Neurodiagnostic Tech Neurophysiology Tech Non-Clinical Tech Nuclear Medicine Tech OB Tech Occupational Therapist (OT) Ophthalmic Technician Orthopedic Tech OT - School OTA OTA - School Paramedic Pathology Assistant Patient Care Tech Perfusionist Pharmacist Pharmacy Tech Phlebotomist Physical Therapist (PT) Physical Therapy Assistant (PTA) Polysomnographic / Sleep Tech Psych Tech Psychologist - School Psychology PT - School Rad Tech Radiation Therapist Recreational Therapist Resp Tech RRT SFA SLP - School SLPA SLPA - School Special Procedures Tech Sped Teacher Speech Language Pathologist (SLP) Sterile Processing Tech Surg Tech Technician Tele Tech Ultrasound Vascular Tech X-Ray Tech	Yes	What type of license a provider applying to your job post needs to have. We use this to appropriately categorize your job.
shift	String	No	Map a client’s shift field to this field if the full shift info is stored in one field
shiftType	String One of the following allowed values: days nights evenings rotating	No	The type of shifts the employee is expected to work.
shiftsPerWeek	Integer	No	The number of shifts per week the employee is expected to work. Values from 3 - 6
hoursPerShift	Integer	No	The number of hours per shift the employee is expected to work. Values from 6 - 16
payAmountMin	Decimal	No	The minimum pay provided by the Client for this Job. This is the bottom end of the pay range.
payAmountMax	Decimal	No	The maximum pay provided by the Client for this Job. This is the top end of the pay range.
payFrequency	String One of the following allowed values: Hourly Weekly	No	The frequency at which a Client pays the Employee for this Job.
employmentType	Enum One of the following allowed values: Full-Time Part-Time Temporary Permanent	No	The type(s) of employment applicable for this job. You can include more than one value from the list of allowed values. See sample feed above for List format example when including multiple values.
durationLength	Integer	No	The numeric length part of the contract duration (e.g. the "13" in "13 weeks").
durationUnit	String One of the following allowed values: day week month year	No	The unit part of the contract duration (e.g. the "weeks" in "13 weeks").
startDate	Date	No	The date your position starts. If left blank, or a date in the past, the start date will automatically be set to ASAP.
description	String	Yes	The description of your job posting. Basic HTML tags are allowed. If using XML, wrap in <![CDATA[ ]]>
requirements	String	No	The minimum requirements a lead applying to your job posting must meet. Basic HTML tags are allowed. If using XML, wrap in <![CDATA[ ]]>
benefits	String	No	The benefits offered by this position. Basic HTML tags are allowed.

Example Request

POST https://www.alliedtravelcareers.com/api/v2.0/jobs.json POST https://www.alliedtravelcareers.com/api/v2.0/jobs.xml

[
    {
        "referenceNumber": "u9FE7VIZ",
        "title": "Job Title",
        "city": "Lancaster",
        "state": "PA",
        "postalCode": "17603",
        "description": "Text or HTML describing this job",
        "requirements": "Text or HTML describing the requirements for this job",
        "license": "PT",
        "shiftType": "days",
        "shiftsPerWeek": 5,
        "hoursPerShift": 8,
        "payAmountMin": "1980.00",
        "payAmountMax": "2420.00",
        "payFrequency": "Weekly",
        "employmentType": [
            "Full-Time",
            "Part-Time",
            "Temporary",
            "Permanent"
        ],
        "durationLength": 13,
        "durationUnit": "week",
        "startDate": "2025-11-05",
        "benefits": "Text or HTML describing the benefits for this job"
    }
]

<?xml version="1.0"?>
<jobs>
  <job>
    <referenceNumber>u9FE7VIZ</referenceNumber>
    <title>Job Title</title>
    <city>Lancaster</city>
    <state>PA</state>
    <postalCode>17603</postalCode>
    <description>Text or HTML describing this job</description>
    <requirements>Text or HTML describing the requirements for this job</requirements>
    <license>PT</license>
    <shiftType>rotating</shiftType>
    <shiftsPerWeek>5</shiftsPerWeek>
    <hoursPerShift>8</hoursPerShift>
    <payAmountMin>1980.00</payAmountMin>
    <payAmountMax>2420.00</payAmountMax>
    <payFrequency>Weekly</payFrequency>
    <employmentType>Full-Time</employmentType>
    <employmentType>Part-Time</employmentType>
    <employmentType>Temporary</employmentType>
    <employmentType>Permanent</employmentType>
    <durationLength>13</durationLength>
    <durationUnit>week</durationUnit>
    <startDate>2025-11-05</startDate>
    <benefits>Text or HTML describing the benefits for this job</benefits>
  </job>
</jobs>

Example Response

{
    "unchanged": 0,
    "updated": 0,
    "added": 1,
    "deleted": 0,
    "errors": 0,
    "errorMessages": {
        "missingErrors": {
            "errors": []
        },
        "invalidErrors": {
            "errors": []
        },
        "duplicationErrors": {
            "errors": []
        },
        "limitErrors": {
            "errors": []
        }
    },
    "ignoredValues": []
}

<?xml version="1.0"?>
<jobs>
  <unchanged>0</unchanged>
  <updated>0</updated>
  <added>1</added>
  <deleted>0</deleted>
  <errors>0</errors>
  <errorMessages>
    <missingErrors>
      <errors/>
    </missingErrors>
    <invalidErrors>
      <errors/>
    </invalidErrors>
    <duplicationErrors>
      <errors/>
    </duplicationErrors>
    <limitErrors>
      <errors/>
    </limitErrors>
  </errorMessages>
  <ignoredValues/>
</jobs>

Retrieve a job

GET https://www.alliedtravelcareers.com/api/v2.0/jobs.json/:id GET https://www.alliedtravelcareers.com/api/v2.0/jobs.xml/:id

URL Parameters


                            REQUIRED


            integer

The ID number of the job you want to fetch.

Query Parameters

No parameters.

Example Request

GET https://www.alliedtravelcareers.com/api/v2.0/jobs.json/7 GET https://www.alliedtravelcareers.com/api/v2.0/jobs.xml/8

Example Response

{
    "id": 7,
    "title": "Job Title",
    "license": "PTA",
    "city": "Lancaster",
    "state": "PA",
    "zip": "17603",
    "shift": "Flex",
    "shiftType": "evenings",
    "shiftsPerWeek": 5,
    "hoursPerShift": 8,
    "payAmountMin": "1980.00",
    "payAmountMax": "2420.00",
    "payFrequency": "Weekly",
    "durationLength": 25,
    "durationUnit": "week",
    "startdate": "2025-11-05",
    "description": "Job Description",
    "requirements": "Job Requirements",
    "benefits": "Text describing the benefits for the position",
    "posted": "2025-11-05",
    "referenceNumber": "TFoVVjnM",
    "employmentType": "Part-Time"
}

<?xml version="1.0"?>
<jobs>
  <job>
    <id>8</id>
    <title>Job Title</title>
    <license>PT</license>
    <city>Lancaster</city>
    <state>PA</state>
    <zip>17603</zip>
    <shift>Flex</shift>
    <shiftType>evenings</shiftType>
    <shiftsPerWeek>5</shiftsPerWeek>
    <hoursPerShift>8</hoursPerShift>
    <payAmountMin>1980.00</payAmountMin>
    <payAmountMax>2420.00</payAmountMax>
    <payFrequency>Weekly</payFrequency>
    <durationLength>25</durationLength>
    <durationUnit>week</durationUnit>
    <startdate>2025-11-05</startdate>
    <description>Job Description</description>
    <requirements>Job Requirements</requirements>
    <benefits>Text describing the benefits for the position</benefits>
    <posted>2025-11-05</posted>
    <referenceNumber>TFoVVjnM</referenceNumber>
    <employmentType>Part-Time</employmentType>
  </job>
</jobs>

Delete a job

DELETE https://www.alliedtravelcareers.com/api/v2.0/jobs.json/:id DELETE https://www.alliedtravelcareers.com/api/v2.0/jobs.xml/:id

URL Parameters


                            REQUIRED


            integer

The ID number of the job you want to delete.

Example Request

DELETE https://www.alliedtravelcareers.com/api/v2.0/jobs.json/12345 DELETE https://www.alliedtravelcareers.com/api/v2.0/jobs.xml/12345

Example Response

{
    "unchanged": 0,
    "updated": 0,
    "added": 0,
    "deleted": 1,
    "errors": 0,
    "errorMessages": {
        "missingErrors": {
            "errors": []
        },
        "invalidErrors": {
            "errors": []
        },
        "duplicationErrors": {
            "errors": []
        },
        "limitErrors": {
            "errors": []
        }
    }
}

<?xml version="1.0"?>
<jobs>
  <unchanged>0</unchanged>
  <updated>0</updated>
  <added>0</added>
  <deleted>1</deleted>
  <errors>0</errors>
  <errorMessages>
    <missingErrors>
      <errors/>
    </missingErrors>
    <invalidErrors>
      <errors/>
    </invalidErrors>
    <duplicationErrors>
      <errors/>
    </duplicationErrors>
    <limitErrors>
      <errors/>
    </limitErrors>
  </errorMessages>
</jobs>

Delete multiple jobs

DELETE https://www.alliedtravelcareers.com/api/v2.0/jobs.json DELETE https://www.alliedtravelcareers.com/api/v2.0/jobs.xml

Example Request

DELETE https://www.alliedtravelcareers.com/api/v2.0/jobs.json DELETE https://www.alliedtravelcareers.com/api/v2.0/jobs.xml

<?xml version="1.0"?>
<jobs>
  <job>12345</job>
  <job>123456</job>
</jobs>

Example Response

{
    "unchanged": 0,
    "updated": 0,
    "added": 0,
    "deleted": 2,
    "errors": 0,
    "errorMessages": {
        "missingErrors": {
            "errors": []
        },
        "invalidErrors": {
            "errors": []
        },
        "duplicationErrors": {
            "errors": []
        },
        "limitErrors": {
            "errors": []
        }
    }
}

<?xml version="1.0"?>
<jobs>
  <unchanged>0</unchanged>
  <updated>0</updated>
  <added>0</added>
  <deleted>2</deleted>
  <errors>0</errors>
  <errorMessages>
    <missingErrors>
      <errors/>
    </missingErrors>
    <invalidErrors>
      <errors/>
    </invalidErrors>
    <duplicationErrors>
      <errors/>
    </duplicationErrors>
    <limitErrors>
      <errors/>
    </limitErrors>
  </errorMessages>
</jobs>

Delete a job by reference

DELETE https://www.alliedtravelcareers.com/api/v2.0/jobs.json/reference/:referenceNumber DELETE https://www.alliedtravelcareers.com/api/v2.0/jobs.xml/reference/:referenceNumber

URL Parameters

referenceNumber


                            REQUIRED


            string

The reference number of the job you want to delete.

Example Request

DELETE https://www.alliedtravelcareers.com/api/v2.0/jobs.json/reference/12345 DELETE https://www.alliedtravelcareers.com/api/v2.0/jobs.xml/reference/12345

Example Response

{
    "unchanged": 0,
    "updated": 0,
    "added": 0,
    "deleted": 1,
    "errors": 0,
    "errorMessages": {
        "missingErrors": {
            "errors": []
        },
        "invalidErrors": {
            "errors": []
        },
        "duplicationErrors": {
            "errors": []
        },
        "limitErrors": {
            "errors": []
        }
    }
}

<?xml version="1.0"?>
<jobs>
  <unchanged>0</unchanged>
  <updated>0</updated>
  <added>0</added>
  <deleted>1</deleted>
  <errors>0</errors>
  <errorMessages>
    <missingErrors>
      <errors/>
    </missingErrors>
    <invalidErrors>
      <errors/>
    </invalidErrors>
    <duplicationErrors>
      <errors/>
    </duplicationErrors>
    <limitErrors>
      <errors/>
    </limitErrors>
  </errorMessages>
</jobs>

Delete multiple jobs by reference

DELETE https://www.alliedtravelcareers.com/api/v2.0/jobs.json/reference DELETE https://www.alliedtravelcareers.com/api/v2.0/jobs.xml/reference

Example Request

DELETE https://www.alliedtravelcareers.com/api/v2.0/jobs.json/reference DELETE https://www.alliedtravelcareers.com/api/v2.0/jobs.xml/reference

[
    "12345",
    "123456"
]

<?xml version="1.0"?>
<jobs>
  <job>12345</job>
  <job>123456</job>
</jobs>

Example Response

{
    "unchanged": 0,
    "updated": 0,
    "added": 0,
    "deleted": 2,
    "errors": 0,
    "errorMessages": {
        "missingErrors": {
            "errors": []
        },
        "invalidErrors": {
            "errors": []
        },
        "duplicationErrors": {
            "errors": []
        },
        "limitErrors": {
            "errors": []
        }
    }
}

<?xml version="1.0"?>
<jobs>
  <unchanged>0</unchanged>
  <updated>0</updated>
  <added>0</added>
  <deleted>2</deleted>
  <errors>0</errors>
  <errorMessages>
    <missingErrors>
      <errors/>
    </missingErrors>
    <invalidErrors>
      <errors/>
    </invalidErrors>
    <duplicationErrors>
      <errors/>
    </duplicationErrors>
    <limitErrors>
      <errors/>
    </limitErrors>
  </errorMessages>
</jobs>