{"info":{"_postman_id":"1947531c-95e6-47b1-a836-525a73272983","name":"Ethical Jobs - XML API","description":"

Introduction

The Ethical Jobs XML API is designed to translate from XML input to JSON output to maintain compatibility with a wide range of job posting distribution systems.

Our API has predictable, resource-oriented URLS and uses standard HTTP response codes to indicate API errors.

We use simple API Key based authentication and only the HTTP POST verb to create new Job ads. JSON is returned by all API responses including errors.

Authentication

Authenticate your account when using the API by including your secret API key in the request. API keys can be organised by contacting your relationships manager. Do not share your secret API key in any publicly accessible areas such as GitHub, client-side code or public repositories.

Authentication to the API is performed by simply including the X-EJ-Authorization header in your request with your API key as the value. All requests to the API must also include your organisation username in the body of the request as the employerid.

All API requests must be made over HTTPS. Please not that calls made over plain HTTP will fail. API requests without any authentication headers will also fail with a 403 Forbidden error.

Errors

Ethical Jobs uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted), and codes in the 5xx range indicate an error with Ethical Jobs' servers.

HTTP status code summary

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status Code	Summary
201 Created	Success, a new job was created.
403 Forbidden	The API key was not provided or is invalid.
404 Not Found	The XML API url is wrong.
422 Unprocessable Entity	Unable to process the entity in question. Could be due to not setting the content type or due to providing a source ID.
500, 502, 503, 504 - Server Errors	Something went wrong on Ethical Job's end

Core Resources

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Introduction","slug":"introduction"},{"content":"Authentication","slug":"authentication"},{"content":"Errors","slug":"errors"},{"content":"Core Resources","slug":"core-resources"}],"owner":"11327147","collectionId":"1947531c-95e6-47b1-a836-525a73272983","publishedId":"Szme3HPN","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2020-05-07T06:52:30.000Z"},"item":[{"name":"/xml/jobs","id":"553177f6-a80a-4a43-955e-00b0203d9c54","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/xml"},{"key":"X-EJ-Authorization","value":"your-api-key"}],"body":{"mode":"raw","raw":"\n\n EthicalJobs\n 7865gd68729h982j32d2938498h\n This is the job title\n This is the job description, its a little bit longer.\n \n apply here]]>\n false\n true\n 2016-12-25 20:35\n nsw\n fulltime\n parttime\n communicationsandmarketing\n fundraising\n socialenterprise\n Not For Profit (NFP)\n"},"url":"https://api.ethicaljobs.com.au/xml/jobs","description":"

Jobs

To create a new advertisement with Ethical Jobs, you create a Job object. You can only create objects and not retrieve or edit them. Jobs are uniquely identified by their provided jobid.

The Job Object

Attributes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Attribute	Description
jobid (string) required	A unique identifier for your job ad.
employerid (string) required	A unique username for your organisation, is provided by your relationships manager.
title (string)	The title for your job ad.
description (string)	The description of your job ad.
body (string)	The main body of the job ad, can contain HTML.
toapply	Instructions for how to apply for the job ad, can contain HTML.
hide-expiry (boolean)	Flag indicating if you want the expiry date hidden or shown
featured (boolean)	Flag indiciating if you would like your job ad to be featured. Featuring an ad costs an extra job credit.
closingdate (timestamp)	Time at which the job ad should close. The timestamp must be provided in the UTC timezone without any timezone offset. Use the ISO 8601 format for the timestamp, e.g., 2024-03-27T20:35:00
location (string)	The location for the job
worktype (string)	The type of work e.g. parttime, fulltime
classification (string)	The classification for the job ad e.g. socialenterprise
sector (string)	The sector that your job ad is in. Can be one of: socialenterprise, notforprofit, forprofit

Vocabularies

It is best to use the slug in your XML to ensure data integrity.

`classification`

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Title	Slug
Administration	administration
Advocacy and Campaigns	advocacy
Aged Care and Seniors Rights	agedcare
Alcohol and Other Drugs	alcoholandotherdrugs
Animal Welfare and Protection	animalwelfareandprotection
Business Development and Sales	businessdevelopment
Care and Support Work	careandsupportservices
Co-ops and Credit Unions	coopsandcreditunions
Communications and Marketing	communicationsandmarketing
Community Development	communityanddevelopment
Conservation and Land Management	conservationandmanagement
Corporate Social Responsibility	corporatesocialresponsibility
Disability Services	disabilityservices
Early Childhood	earlychildhood
Eco-Tourism	ecotourism
Education and Training	educationandtraining
Environment and Sustainability	environmentandsustainability
Executive and Senior Management	executiveseniormanagement
Family Services	familyservices
FairTrade and Organic	fairtradeorganicandecoretail
Finance and Accounting	financeandaccounting
Fundraising	fundraising
LGBTQIA+	glbt
Green Architecture/Property	greenarchitectureandproperty
Green Energy	greenenergy
Green Products and Services	greenproductsandservices
Health Care and Allied Health	healthcare
Health Promotion	healthpromotion
Housing and Homelessness	housing
Retail and Hospitality	retailandhospitality
HR and Employment Services	hrandemploymentservices
Indigenous	indigenous
International Aid and Development	internationalaidandevelopment
Information Technology & Digital	itandcommunicationtechnology
Legal and Human Rights	legalandhumanrights
Management	management
Media and Arts	mediaartsandentertainment
Medical Research	medicalresearch
Mental Health and Counselling	mentalhealthandcounselling
Multiculturalism and Diversity	multiculturalismdiversity
Nursing	nursing
Operations and Risk Management	operationsriskmanagement
Organic Farming and Gardening	organicfarmingandgardening
Policy and Research	policyandresearch
Project Management	projectmanagement
Recycling and Waste Management	recyclingandwastemanagement
Social Work	socialwork
Sustainable Transport	sustainabletransport
Trades and Services	tradesandservices
Unions and Workers Rights	unionsandworkersrights
Volunteer Management	volunteermanagement
Womens Organisations and Services	womensorganisationsandservices
Youth	youthservices
Domestic & Family Violence	domesticfamilyviolence
Events Management	events

`location`

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Title	Slug
Melbourne	VIC
Regional VIC	REGVIC
Sydney	NSW
Regional NSW	REGNSW
Brisbane & Gold Coast	QLD
Regional QLD	REGQLD
Perth	WA
Regional WA	REGWA
Adelaide	SA
Regional SA	REGSA
Hobart	TAS
Regional TAS	REGTAS
Darwin	NT
Regional NT	REGNT
Canberra & ACT	ACT
International	INTERNATIONAL

`worktype`

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Title	Slug
Casual	CASUAL
Contract	CONTRACT
Full Time	FULLTIME
Graduate	GRADUATE
Part Time	PARTTIME
Volunteer	VOLUNTEER
Board Member	BOARDMEMBER
Remote / Work from home	REMOTE

`sector`

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Title	Slug
Business/Private Sector	Business and Private Sector
Federal Government	Federal Government
Local Government	Local Government
Not For Profit (NFP)	Not For Profit (NFP)
Social Enterprise	socialenterprise
State Government	State Government
University & Higher Education	university

","urlObject":{"protocol":"https","path":["xml","jobs"],"host":["api","ethicaljobs","com","au"],"query":[],"variable":[]}},"response":[{"id":"e451fd85-d6d3-44c1-9ec6-7110232a4a38","name":"Failure","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/xml"}],"body":{"mode":"raw","raw":"\n\n EthicalJobs\n 7865gd68729h982j32d2938498h\n This is the job title\n This is the job description, its a little bit longer.\n \n apply here]]>\n false\n true\n 2016-12-25 20:35\n nsw\n fulltime\n parttime\n communicationsandmarketing\n fundraising\n socialenterprise\n Not For Profit (NFP)\n"},"url":"https://api.ethicaljobs.com.au/xml/jobs"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Credentials","value":"true","name":"Access-Control-Allow-Credentials","description":""},{"key":"Access-Control-Allow-Headers","value":"Accept,Authorization,Cache-Control,Content-Type,DNT,If-Modified-Since,Keep-Alive,Origin,User-Agent,X-Requested-With","name":"Access-Control-Allow-Headers","description":""},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, PATCH, DELETE, OPTIONS","name":"Access-Control-Allow-Methods","description":""},{"key":"Access-Control-Allow-Origin","value":"*","name":"Access-Control-Allow-Origin","description":""},{"key":"Access-Control-Expose-Headers","value":"Authorization","name":"Access-Control-Expose-Headers","description":""},{"key":"Cache-Control","value":"no-cache","name":"Cache-Control","description":""},{"key":"Content-Encoding","value":"gzip","name":"Content-Encoding","description":""},{"key":"Content-Length","value":"61","name":"Content-Length","description":""},{"key":"Content-Type","value":"application/json","name":"Content-Type","description":""},{"key":"Date","value":"Wed, 08 Nov 2017 05:52:14 GMT","name":"Date","description":""},{"key":"Server","value":"nginx","name":"Server","description":""},{"key":"Vary","value":"Accept-Encoding","name":"Vary","description":""},{"key":"X-Powered-By","value":"PHP/7.1.2","name":"X-Powered-By","description":""}],"cookie":[],"responseTime":null,"body":"{\"message\":\"403 Forbidden\",\"statusCode\":403}"},{"id":"f7572a47-4c84-4e9d-9ddf-45c9452406f4","name":"Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/xml"},{"key":"X-EJ-Authorization","value":"your-api-key"}],"body":{"mode":"raw","raw":"\n\n EthicalJobs\n 7865gd68729h982j32d2938498h\n This is the job title\n This is the job description, its a little bit longer.\n \n apply here]]>\n false\n true\n 2016-12-25 20:35\n nsw\n fulltime\n parttime\n communicationsandmarketing\n fundraising\n socialenterprise\n Not For Profit (NFP)\n"},"url":"https://api.ethicalstaging.com.au/xml/jobs"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Credentials","value":"true","name":"Access-Control-Allow-Credentials","description":""},{"key":"Access-Control-Allow-Headers","value":"Accept,Authorization,Cache-Control,Content-Type,DNT,If-Modified-Since,Keep-Alive,Origin,User-Agent,X-Requested-With","name":"Access-Control-Allow-Headers","description":""},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, PATCH, DELETE, OPTIONS","name":"Access-Control-Allow-Methods","description":""},{"key":"Access-Control-Allow-Origin","value":"*","name":"Access-Control-Allow-Origin","description":""},{"key":"Access-Control-Expose-Headers","value":"Authorization","name":"Access-Control-Expose-Headers","description":""},{"key":"Cache-Control","value":"no-cache","name":"Cache-Control","description":""},{"key":"Content-Length","value":"643","name":"Content-Length","description":""},{"key":"Content-Type","value":"application/json","name":"Content-Type","description":""},{"key":"Date","value":"Wed, 08 Nov 2017 05:57:49 GMT","name":"Date","description":""},{"key":"Server","value":"nginx","name":"Server","description":""},{"key":"X-Powered-By","value":"PHP/7.1.2","name":"X-Powered-By","description":""}],"cookie":[],"responseTime":null,"body":"{\"source\":\"AUTOPOST\",\"source_id\":\"7865gd68729h982j32d2938498h\",\"source_provider\":\"N\\/A\",\"organisation_uid\":\"EthicalJobs\",\"title\":\"This is the job title\",\"summary\":\"This is the job description, its a little bit longer.\",\"description\":\"This is the job body, its a little bit longer then the description.\",\"application\":\"This is how to apply for this job apply here<\\/a>\",\"featured\":1,\"expiration_hidden\":0,\"location_id\":\"NSW\",\"categories\":[\"communicationsandmarketing\",\"fundraising\"],\"workTypes\":[\"FULLTIME\",\"PARTTIME\"],\"sectors\":[\"socialenterprise\",\"Not For Profit (NFP)\"],\"expires_at\":1482698100000,\"id\":80474}"}],"_postman_id":"553177f6-a80a-4a43-955e-00b0203d9c54"},{"name":"Staging - XML API - Post Example","id":"2e8c93de-8572-495a-b3f7-3f82e44f18ff","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/xml"},{"key":"X-EJ-Authorization","value":"qweqweasdasdzxczxc"}],"body":{"mode":"raw","raw":"\n\n EthicalJobs\n 7865gd68729h982j32d2938498h\n This is the job title\n This is the job description, its a little bit longer.\n \n apply here]]>\n false\n true\n 2016-12-25 20:35\n nsw\n fulltime\n parttime\n communicationsandmarketing\n fundraising\n socialenterprise\n Not For Profit (NFP)\n"},"url":"https://api.staging.ethicalstg.com.au/xml/jobs","description":"

Jobs

See above.

\n","urlObject":{"protocol":"https","path":["xml","jobs"],"host":["api","staging","ethicalstg","com","au"],"query":[],"variable":[]}},"response":[{"id":"43e50e69-d8db-4b80-a43c-7a6d7a87645e","name":"Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/xml"},{"key":"X-EJ-Authorization","value":"your-api-key"}],"body":{"mode":"raw","raw":"\n\n EthicalJobs\n 7865gd68729h982j32d2938498h\n This is the job title\n This is the job description, its a little bit longer.\n \n apply here]]>\n false\n true\n 2016-12-25 20:35\n nsw\n fulltime\n parttime\n communicationsandmarketing\n fundraising\n socialenterprise\n Not For Profit (NFP)\n"},"url":"https://api.ethicalstaging.com.au/xml/jobs"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Credentials","value":"true","name":"Access-Control-Allow-Credentials","description":"Indicates whether or not the response to the request can be exposed when the credentials flag is true. When used as part of a response to a preflight request, this indicates whether or not the actual request can be made using credentials."},{"key":"Access-Control-Allow-Headers","value":"Accept,Authorization,Cache-Control,Content-Type,DNT,If-Modified-Since,Keep-Alive,Origin,User-Agent,X-Requested-With","name":"Access-Control-Allow-Headers","description":"Used in response to a preflight request to indicate which HTTP headers can be used when making the actual request."},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, PATCH, DELETE, OPTIONS","name":"Access-Control-Allow-Methods","description":"Specifies the method or methods allowed when accessing the resource. This is used in response to a preflight request."},{"key":"Access-Control-Allow-Origin","value":"*","name":"Access-Control-Allow-Origin","description":"Specifies a URI that may access the resource. For requests without credentials, the server may specify '*' as a wildcard, thereby allowing any origin to access the resource."},{"key":"Access-Control-Expose-Headers","value":"Authorization","name":"Access-Control-Expose-Headers","description":"Lets a server whitelist headers that browsers are allowed to access."},{"key":"Cache-Control","value":"no-cache","name":"Cache-Control","description":"Tells all caching mechanisms from server to client whether they may cache this object. It is measured in seconds"},{"key":"Content-Length","value":"643","name":"Content-Length","description":"The length of the response body in octets (8-bit bytes)"},{"key":"Content-Type","value":"application/json","name":"Content-Type","description":"The mime type of this content"},{"key":"Date","value":"Wed, 08 Nov 2017 05:57:49 GMT","name":"Date","description":"The date and time that the message was sent"},{"key":"Server","value":"nginx","name":"Server","description":"A name for the server"},{"key":"X-Powered-By","value":"PHP/7.1.2","name":"X-Powered-By","description":"Specifies the technology (ASP.NET, PHP, JBoss, e.g.) supporting the web application (version details are often in X-Runtime, X-Version, or X-AspNet-Version)"}],"cookie":[],"responseTime":null,"body":"{\"source\":\"AUTOPOST\",\"source_id\":\"7865gd68729h982j32d2938498h\",\"source_provider\":\"N\\/A\",\"organisation_uid\":\"EthicalJobs\",\"title\":\"This is the job title\",\"summary\":\"This is the job description, its a little bit longer.\",\"description\":\"This is the job body, its a little bit longer then the description.\",\"application\":\"This is how to apply for this job apply here<\\/a>\",\"featured\":1,\"expiration_hidden\":0,\"location_id\":\"NSW\",\"categories\":[\"communicationsandmarketing\",\"fundraising\"],\"workTypes\":[\"FULLTIME\",\"PARTTIME\"],\"sectors\":[\"socialenterprise\",\"Not For Profit (NFP)\"],\"expires_at\":1482698100000,\"id\":80474}"},{"id":"ea35c21d-794c-435c-9977-affb6ae8c861","name":"Failure","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/xml"}],"body":{"mode":"raw","raw":"\n\n EthicalJobs\n 7865gd68729h982j32d2938498h\n This is the job title\n This is the job description, its a little bit longer.\n \n apply here]]>\n false\n true\n 2016-12-25 20:35\n nsw\n fulltime\n parttime\n communicationsandmarketing\n fundraising\n socialenterprise\n Not For Profit (NFP)\n"},"url":"https://api.ethicaljobs.com.au/xml/jobs"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Credentials","value":"true","name":"Access-Control-Allow-Credentials","description":"Indicates whether or not the response to the request can be exposed when the credentials flag is true. When used as part of a response to a preflight request, this indicates whether or not the actual request can be made using credentials."},{"key":"Access-Control-Allow-Headers","value":"Accept,Authorization,Cache-Control,Content-Type,DNT,If-Modified-Since,Keep-Alive,Origin,User-Agent,X-Requested-With","name":"Access-Control-Allow-Headers","description":"Used in response to a preflight request to indicate which HTTP headers can be used when making the actual request."},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, PATCH, DELETE, OPTIONS","name":"Access-Control-Allow-Methods","description":"Specifies the method or methods allowed when accessing the resource. This is used in response to a preflight request."},{"key":"Access-Control-Allow-Origin","value":"*","name":"Access-Control-Allow-Origin","description":"Specifies a URI that may access the resource. For requests without credentials, the server may specify '*' as a wildcard, thereby allowing any origin to access the resource."},{"key":"Access-Control-Expose-Headers","value":"Authorization","name":"Access-Control-Expose-Headers","description":"Lets a server whitelist headers that browsers are allowed to access."},{"key":"Cache-Control","value":"no-cache","name":"Cache-Control","description":"Tells all caching mechanisms from server to client whether they may cache this object. It is measured in seconds"},{"key":"Content-Encoding","value":"gzip","name":"Content-Encoding","description":"The type of encoding used on the data."},{"key":"Content-Length","value":"61","name":"Content-Length","description":"The length of the response body in octets (8-bit bytes)"},{"key":"Content-Type","value":"application/json","name":"Content-Type","description":"The mime type of this content"},{"key":"Date","value":"Wed, 08 Nov 2017 05:52:14 GMT","name":"Date","description":"The date and time that the message was sent"},{"key":"Server","value":"nginx","name":"Server","description":"A name for the server"},{"key":"Vary","value":"Accept-Encoding","name":"Vary","description":"Tells downstream proxies how to match future request headers to decide whether the cached response can be used rather than requesting a fresh one from the origin server."},{"key":"X-Powered-By","value":"PHP/7.1.2","name":"X-Powered-By","description":"Specifies the technology (ASP.NET, PHP, JBoss, e.g.) supporting the web application (version details are often in X-Runtime, X-Version, or X-AspNet-Version)"}],"cookie":[],"responseTime":null,"body":"{\"message\":\"403 Forbidden\",\"statusCode\":403}"}],"_postman_id":"2e8c93de-8572-495a-b3f7-3f82e44f18ff"}]}