List job listings

This API retrieves the list of job listings available for your account.

Endpoint

POST https://canadamotorjobs.com/api/v1/{locale}/job-listings

The API requires Bearer authentication. Include the token in the request header:

Authorization: Bearer <your_token>

Parameter	Type	Description	Required	Default
page	number	Page number	No	1
locale	string: en, fr, es	Job listing language	No	fr
limit	number	Number of items per page	No	10
search	string	Search term	No	null
location	string	Location	No	null
category	string	Job category	No	null

Field	Type	Description
id	string	Unique job listing identifier from our site
ref_id	string\|null	Reference identifier in your system
name	string	Job listing name
business.id	string	Unique business identifier from our site
business.ref_id	string\|null	Business reference identifier in your system
business.name	string	Business name
business.logo	string	Business logo URL
business.location	string	Business address
business.lat	number	Business latitude
business.lng	number	Business longitude
logo	string	Job listing logo URL
location	string	Position address
lat	number	Position latitude
lng	number	Position longitude
distance	float\|null	Distance in km between the provided location and the job listing
salary.value	float	Salary amount
salary.hourly	boolean	Whether salary is calculated on an hourly basis
salary.show	boolean	Whether salary should be displayed
salary.method	string	Salary calculation method
salary.before_text	string	Text to display before salary
salary.commissions	boolean	Whether salary includes commissions
salary.bonusses	boolean	Whether salary includes bonuses
salary.html	html	HTML representation of salary
type	string	Position type
sector	string	Business sector
department	string	Department
job_title	string	Job title
status	string	Job listing status
activated_at	string	Activation date
start_at	string	Start date
end_at	string	End date
filled_at	string	Date the position was filled
created_at	string	Creation date
updated_at	string	Last update date
applications_count	number	Number of applications received

{
  "error": "Invalid or missing authentication token"
}

{
  "error": "You do not have the necessary permissions"
}

curl -X GET \
  'https://api.canadamotorjobs.com/api/job-listings?page=1&limit=10' \
  -H 'Authorization: Bearer your_token_here'