📘
Enterprise Plan
The JobBoard.io API is available on the Enterprise plan and allows developers to create applications that can create and/or access certain site resources on your JobBoard.io site.
To upgrade, contact us.

Getting Started

To assist with getting to know the JobBoard.io API, we recommend using a command line tool such as cURL. cURL comes pre-installed on Mac OS X and most Linux distributions and can be downloaded for Windows from the curl website. Please check that your cURL installation supports HTTPS.

We’ll use cURL throughout the examples below.

The API is implemented as JSON over HTTPS using RESTful commands – GET, POST, DELETE or PATCH.

Authentication

API requests are made via HTTPS using your account’s unique API key. Each request must be authenticated by including this API key in the request header as X-Api-Key. You can find your API token in Site Config.

❗️
Sharing your API key
Treat your API key as you would a password. If you believe your API key has been disclosed to an unauthorized third party, press the 'refresh' button to get a new key. Applications which use the existing API key will no longer be able to access the API.

Reading from the API (GET)

By using a GET request, you can retrieve information about jobs posted to your JobBoard.io account. Please ensure https://yourjobboardaddress.jobboard.io/ is replaced with your JobBoard.io URL.

curl -v GET \
  -H "X-Api-Key: YOURAPIKEYHERE" \
  -H "Content-Type: application/json" \
 https://yourjobboardaddress.jobboard.io/api/v1/jobs/search

Writing to the API (POST)

By using a POST request, you can post jobs directly to your JobBoard.io account. Ensure https://yourjobboardaddress.jobboard.io/ is replaced with your JobBoard.io URL.

curl -v POST \
  -H "X-Api-Key: YOURAPIKEYHERE" \
  -H "Content-Type: application/json" \
  -D "title:Developer" \
  -D "company:JobBoard.io" \
  -D "apply_email:tim@apple.com" \
  -D "description:Insert Description Here" \
  -D "company_url:http://apple.com" \
  -D "published:true" \
  -D "featured:true" \
  
 https://yourjobboardaddress.jobboard.io/api/v1/jobs.json

The request header must contain your X-Api-Key and "Content-Type: application/json"

The request body must contain:

Request Key	Request Value Example	Required?
title	Developer	Yes
company	Apple	Yes
location	London	Yes
apply_url	http://careers.apple.com	Must have an apply method (apply_url or apply_email)
apply_email	tim@apple.com	Must have an apply method (apply_url or apply_email)
description	We are building a new platform for linking virtual content to locations. We use QR codes, low energy bluetooth, and other hardware. Join our team today!	Yes
company_url	http://apple.com	No
published	true or false	Yes
featured	true or false	Yes

Unsuccessful POST Response Example

When purchase email, nor apply method was correctly specified.

{
  "message": {
    "purchaser_email": [
      "can't be blank"
    ],
    "base": [
      "You must provide an apply method."
    ]
  }
}

Troubleshooting

When an API request succeeds the response header will include an HTTP status of 200 (or 201 where a new record is created). All other HTTP status codes indicate that there has been an error with the request.

HTTP Status	Definition
200	Success
401	Unauthorized - Check X-Api-Key is present in your request header.
404	Not Found
422	Client Error - Check your response body for specific details as to missing or invalid fields