The JobBoard.io API allows developers to create applications that can get or post jobs to your job board.

📘

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:[email protected]" \
  -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

[email protected]

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