You can integrate your Loxo Job Listing into your website in one of two ways.
- The easiest way is to redirect your website's Careers page to your Loxo Job Listing.
- If you want a deeper integration so that your job listing blends in with your website design, you can request a secure API key by emailing support@loxo.co, then share that and the following API documentation with your software development team.
API Documentation
All endpoints use HTTP Basic Auth. Contact Loxo for your credentials.
The query is pulling jobs from Loxo. We support passing in the parameter published
(which can be true or false), and also a job_status_id, which could correlate to active, inactive, etc
Countries
GET /api/{agency_key}/countries
Displays a listing of countries
State
GET /api/{agency_key}/countries/{country_id}/states
Displays a listing of states for a country
Job Types
GET /api/{agency_key}/job_types
Displays a listing of job types
Job Statuses
GET /api/{agency_key}/job_statuses
Displays a listing of job statuses
Jobs
GET /api/{agency_key}/jobs
Displays a listing of jobs
Job Categories
GET /api/{agency_key}/job_categories
Display a listing of job categories
Params:
- job_type_id [integer, optional] -- one of the job type ids from the API call above
- query [string, optional] -- a full-text search query to search across all jobs
- job_status_id [integer, optional] -- one of the job status ids from the API call above
- page [integer, optional] -- the page of results to view
- per_page [integer, optional] -- how many results to display per page
- published [boolean, optional] -- show published or unpublished jobs
GET /api/{agency_key}/jobs/{job_id}
Displays a single job
POST /api/{agency_key}/jobs
Create new job
Params:
- job -- the following parameters must be inside a job object {“job”: {...}}
- title [string, required] -- the job title
- published [boolean, required] -- is the job published for public display
- raw_company_name [string, required] -- the name of the company this job belongs to
- address [string, optional] -- street address for job
- city [string, optional] -- job city is in
- state_id [integer, optional] -- ID of the state the job is in
- zip [string, optional] -- zip code for job (can contain alpha chars in certain countries)
- country_id [integer, optional] -- ID of the country the job is in
- Description [string, optional] -- public-facing job description
- internal_notes [string, optional] -- internal job description/notes
- salary [string, optional] -- expected compensation for job
- job_type_id [integer, optional] -- ID of the job type
- job_status_id [integer, optional] -- ID of the job status
- published_at [datetime, optional] -- if present, use this as the publish date of the job instead of the created date
PUT /api/{agency_key}/jobs/{job_id}
Update existing job
Params: same as for create
DELETE /api/{agency_key}/jobs/{job_id}
Delete an existing job
POST /api/{agency_key}/jobs/{job_id}/apply
Apply to a job
Params:
- name [string, required] -- the candidate's name
- phone [string, required] -- the candidate's phone number
- email [string, required] -- the candidate's email address
- resume [file upload, required] -- the candidate's resume file