NAV
curl

Introduction

API Endpoint

https://api.homerun.co

Welcome to the Homerun API! You can use our API to access Homerun API endpoints, which can get information on jobs and candidates in our database.

You can view code examples in the dark area to the right. Currently, we don’t have any SDK’s yet.

Authentication

Example Request

$ curl "https://api.homerun.co/v1/candidates" \
    -u "YOUR_API_KEY:"

curl uses the -u flag to pass basic auth credentials. Adding a colon after the API key prevents cURL from asking for a password.

Make sure to replace YOUR_API_KEY with your API key.

Include your API key in every request you make. Be sure to keep your API key secret at any time! It comes with great power. Don’t share your API key in publicly accessible places such as client-side code or services like Github.

Authentication to the API is performed via HTTP Basic Auth. Provide your API key as the basic auth username value. You do not need to provide a password.

If you need to authenticate via bearer auth (e.g., for a cross-origin request), use -H "Authorization: Bearer YOUR_API_KEY" instead of -u YOUR_API_KEY:.

Errors

The Homerun API uses the following error codes:

Error Code Meaning
400 Bad Request – Your request was not acceptable.
401 Unauthorized – Your API key is invalid.
403 Forbidden – The requested resource is hidden for the used API key.
404 Not Found – The specified resource could not be found.
405 Method Not Allowed – You tried to access a resource with an invalid method.
410 Gone – The resource requested has been removed from our servers.
429 Too Many Requests – You’re requesting too much in too little time. The current rate limit is 60 requests per minute.
500 Internal Server Error – We had a problem with our server. Try again later.
503 Service Unavailable – We’re temporarially offline for maintanance. Please try again later.

Expanding Objects

Example Request

$ curl "https://api.homerun.co/v1/candidates/ca_pGIMQgRcwO3jaBzygcq3?expand[]=applications.job" \
    -u "YOUR_API_KEY:" \
    -G

Some objects contain the ID of a related object in their response properties. For example, an Application has an associated Candidate ID. Those objects can be expanded inline with the expand request parameter. Objects that can be expanded are noted in this documentation. This parameter is available on all API requests, and applies to the response of that request only.

You can nest expand requests with the dot property. For example, requesting applications.job on a Candidate will expand the applications property into a full Application object, and will then expand the job property on that application into a full Job object.

You can expand multiple objects at once by identifying multiple items in the expand array.

Pagination

Example Request

$ curl "https://api.homerun.co/v1/jobs?limit=3" \
    -u "YOUR_API_KEY:" \
    -G

Example Response

{
  "data": [
    {
      "id": "job_OHfvy0C4NBnJ5UCoQkaV",
      "active_time": [
        {
          "opened_at": 1401379882,
          "closed_at": null
        }
      ],
      "application_form_url": "https://agency.homerun.co/marketing-manager/apply",
      "created_at": 1401374763,
      "job_url": "https://agency.homerun.co/marketing-manager",
      "share_image_url": "https://d2zr9w65gdacs9.cloudfront.net/53/photo-1465657031025-5c9e77ddf9ca1469458947full-width.jpg",
      "status": "open",
      "title": "Marketing Manager",
      "tmp_department": null,
      "tmp_location": "Amsterdam",
      "total_candidate_count": 36,
      "type": "Full-time"
    },
    {...},
    {...}
  ],
  "has_more": false
}

All top-level API resources have support for bulk fetches via “list” API methods. These list API methods share a common structure, taking these three parameters: limit, ending_before and starting_after.

Homerun utilizes cursor-based pagination via the ending_before and starting_after parameters. Both take an existing object ID value (see below). The ending_before parameter returns objects created before the named object, in descending chronological order. The starting_after parameter returns objects created after the named object, in ascending chronological order. If both parameters are provided, only ending_before is used.

Arguments  
ending_before optional A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.
limit optional, default is 100 A limit on the number of results to return. Limit can be any number between 1 and 500.
starting_after optional A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.

Applications

The application object

Example Response

{
  "id": "ap_uP6L6sHDibDQmY8Sh52O",
  "candidate": "ca_pLgKO7T4wwmBXgYGfpss",
  "content": {},
  "created_at": 1487835353,
  "disqualified": false,
  "hired_at": 1544779957,
  "job": "job_jfGhv8FnurJalJTmp8I1",
  "personal_info": {
    "city": "Rotterdam",
    "country": "The Netherlands",
    "date_of_birth": "1983-01-28",
    "phone_number": "012-34567890",
    "photo": "https://d2zr9w65gdacs9.cloudfront.net/53/14da63a1435155015.jpg"
  },
  "rating": 2.5,
  "rejected": false,
  "retention_period_ends_at": 1544799951,
  "sourced": false,
  "total_votes": 2,
  "url": "https://app.homerun.co/job/123/candidate/456"
}
Attributes  
id string Unique ID of the object.
candidate string ID of the candidate the application belongs to.

content object Content attached to the application. Only returned when retrieving a single application.
created_at timestamp Time on which the application was created.
disqualified boolean Whether or not the application has the disqualified status.
hired_at timestamp Time on which the application was marked as hired.
job string ID of the job the application is attached to.

personal_info object Personal information attached to the application: city, country, date_of_birth, phone_number, photo.
rating decimal The average rating of the application.
rejected boolean Whether or not the application has the rejected status.
retention_period_ends_at timestamp Time on which the application retention period ends.
sourced boolean Whether or not the application was added by the team.
total_votes integer Total number of votes for the application.
url string URL to the application in Homerun. (You may notice that at the moment different ID’s are being used in the URL than you’d expect; this will change in a future update.)

Create an application

Definition

POST https://api.homerun.co/v1/applications

Example Request

$ curl "https://api.homerun.co/v1/applications" \
    -u "YOUR_API_KEY:" \
    -d "candidate=ca_pLgKO7T4wwmBXgYGfpss" \
    -d "city=Rotterdam" \
    -d "content[education]=University of Amsterdam" \
    -d "country=The Netherlands" \
    -d "date_of_birth=1983-01-28" \
    -d "job=job_jfGhv8FnurJalJTmp8I1" \
    -d "phone_number=012-34567890" \
    -d "photo=https://d2zr9w65gdacs9.cloudfront.net/53/14da63a1435155015.jpg"

Example Response

{
  "id": "ap_uP6L6sHDibDQmY8Sh52O",
  "candidate": {
    "id": "ca_pLgKO7T4wwmBXgYGfpss",
    "applications": [
      "ap_uP6L6sHDibDQmY8Sh52O"
    ],
    "created_at": 1487835353,
    "email": "marc@smith.co",
    "first_name": "Marc",
    "last_name": "Smith",
    "most_recent_photo": "https://d2zr9w65gdacs9.cloudfront.net/53/14da63a1435155015.jpg"
  },
  "content": {
    "education": "University of Amsterdam"
  },
  "created_at": 1487835353,
  "disqualified": false,
  "hired_at": null,
  "job": "job_jfGhv8FnurJalJTmp8I1",
  "personal_info": {
    "city": "Rotterdam",
    "country": "The Netherlands",
    "date_of_birth": "1983-01-28",
    "phone_number": "012-34567890",
    "photo": "https://d2zr9w65gdacs9.cloudfront.net/53/14da63a1435155015.jpg"
  },
  "rating": 0,
  "rejected": false,
  "retention_period_ends_at": 1544799951,
  "sourced": true,
  "total_votes": 0,
  "url": "https://app.homerun.co/job/123/candidate/456"
}

Create a new application.

Arguments  
candidate required ID of the candidate the application belongs to.
city optional The city that is part of the personal information attached to the application.
content optional, as array Any content you want to store with the application.
country optional The country that is part of the personal information attached to the application.
date_of_birth optional The date of birth that is part of the personal information attached to the application.
job optional If set, the application will be attached to this job.
phone_number optional The phone number that is part of the personal information attached to the application.
photo optional URL of the photo that is part of the personal information attached to the application.
sourced optional, default is true Whether or not the application should be marked as sourced.

Retrieve an application

Definition

GET https://api.homerun.co/v1/applications/{id}

Example Request

$ curl "https://api.homerun.co/v1/applications/ap_uP6L6sHDibDQmY8Sh52O?expand[]=candidate&expand[]=job" \
    -u "YOUR_API_KEY:" \
    -G

Example Response

{
  "id": "ap_uP6L6sHDibDQmY8Sh52O",
  "candidate": {
    "id": "ca_pLgKO7T4wwmBXgYGfpss",
    "applications": [
      "ap_uP6L6sHDibDQmY8Sh52O"
    ],
    "created_at": 1487835353,
    "email": "marc@smith.co",
    "first_name": "Marc",
    "last_name": "Smith",
    "most_recent_photo": "https://d2zr9w65gdacs9.cloudfront.net/53/14da63a1435155015.jpg"
  },
  "content": {
    "education": "University of Amsterdam"
  },
  "created_at": 1487835353,
  "disqualified": false,
  "hired_at": 1544779957,
  "job": {
    "id": "job_jfGhv8FnurJalJTmp8I1",
    "active_time": [
      {
        "opened_at": 1487596923,
        "closed_at": null
      }
    ],
    "application_form_url": "https://agency.homerun.co/account-manager/apply",
    "created_at": 1487595603,
    "job_url": "https://agency.homerun.co/account-manager",
    "share_image_url": null,
    "status": "open",
    "title": "Account Manager",
    "tmp_department": null,
    "tmp_location": "Amsterdam",
    "total_candidate_count": 36,
    "type": "Full-time"
  },
  "personal_info": {
    "city": "Rotterdam",
    "country": "The Netherlands",
    "date_of_birth": "1983-01-28",
    "phone_number": "012-34567890",
    "photo": "https://d2zr9w65gdacs9.cloudfront.net/53/14da63a1435155015.jpg"
  },
  "rating": 2.5,
  "rejected": false,
  "retention_period_ends_at": 1544799951,
  "sourced": false,
  "total_votes": 2,
  "url": "https://app.homerun.co/job/123/candidate/456"
}

Retrieve a specified application.

Arguments  
id required The ID of the application to retrieve.

Update an application

Definition

PUT https://api.homerun.co/v1/applications/{id}

Example Request

$ curl "https://api.homerun.co/v1/applications/ap_uP6L6sHDibDQmY8Sh52O" \
    -X PUT \
    -u "YOUR_API_KEY:" \
    -d "city=Amsterdam" \
    -d "content[address]=Street 123"

Example Response

{
  "id": "ap_uP6L6sHDibDQmY8Sh52O",
  "candidate": "ca_pLgKO7T4wwmBXgYGfpss",
  "content": {
    "address": "Street 123",
    "education": "University of Amsterdam"
  },
  "created_at": 1487835353,
  "disqualified": false,
  "hired_at": null,
  "job": "job_jfGhv8FnurJalJTmp8I1",
  "personal_info": {
    "city": "Amsterdam",
    "country": "The Netherlands",
    "date_of_birth": "1983-01-28",
    "phone_number": "012-34567890",
    "photo": "https://d2zr9w65gdacs9.cloudfront.net/53/14da63a1435155015.jpg"
  },
  "rating": 0,
  "rejected": false,
  "retention_period_ends_at": 1544799951,
  "sourced": true,
  "total_votes": 0,
  "url": "https://app.homerun.co/job/123/candidate/456"
}

Update an existing application.

Arguments  
city optional The city that is part of the personal information attached to the application.
content optional, as array Any content you want to store with the application.
country optional The country that is part of the personal information attached to the application.
date_of_birth optional The date of birth that is part of the personal information attached to the application.
job optional If set, the application will be moved to this job.
phone_number optional The phone number that is part of the personal information attached to the application.
photo optional URL of the photo that is part of the personal information attached to the application.
sourced optional Whether or not the application should be marked as sourced.

List all applications

Definition

GET https://api.homerun.co/v1/applications

Example Request

$ curl "https://api.homerun.co/v1/applications" \
    -u "YOUR_API_KEY:"

Example Response

{
  "data": [
    {
      "id": "ap_uP6L6sHDibDQmY8Sh52O",
      "candidate": "ca_pLgKO7T4wwmBXgYGfpss",
      "created_at": 1487835353,
      "disqualified": false,
      "hired_at": 1544779957,
      "job": "job_jfGhv8FnurJalJTmp8I1",
      "personal_info": {
        "city": "Rotterdam",
        "country": "The Netherlands",
        "date_of_birth": "1983-01-28",
        "phone_number": "012-34567890",
        "photo": "https://d2zr9w65gdacs9.cloudfront.net/53/14da63a1435155015.jpg"
      },
      "rating": 2.5,
      "rejected": false,
      "retention_period_ends_at": 1544799951,
      "sourced": false,
      "total_votes": 2,
      "url": "https://app.homerun.co/job/123/candidate/456"
    }
  ],
  "has_more": false
}

You can list all applications, or list the applications from a specific job. The applications are sorted by date, with the most recently created applications appearing first.

Arguments  
job optional If set, only applications attached to this job will be returned.

Application Files

The files object

Example Response

[
  {
    "id": "file_pq3Zu1tYlb7LfeTbRU2N",
    "filename": "resume.pdf",
    "url": "https:\/\/files.homerun.co\/job_application\/123\/file_pq3Zu1tYlb7LfeTbRU2N\/resume.pdf?key=4f4c0af511c6958dds9c8359763718d1ae17e987dc2b2ecwaeb5779d23829384"
  },
  {
    "id": "file_Ai1UsMGI88ZVjDCRFEw7",
    "filename": "coverletter.pdf",
    "url": "https:\/\/files.homerun.co\/job_application\/123\/file_Ai1UsMGI88ZVjDCRFEw7\/coverletter.pdf?key=53fb99d11eed6fd43ud6a21bf45b2bf5e7266357f8fxa2a7f90e5b491f578373"
  }
]
Attributes  
id string Unique ID of the file.
filename string Filename of the file.
url string Public URL to the file in Homerun.

Create a file

Definition

POST https://api.homerun.co/v1/applications/{id}/files

Example Request

$ curl "https://api.homerun.co/v1/applications/ap_uP6L6sHDibDQmY8Sh52O/files" \
    -u "YOUR_API_KEY:" \
    -F file="@/path/to/file.pdf"

Example Response

{
  "id": "file_pq3Zu1tYlb7LfeTbRU2N",
  "filename": "file.pdf",
  "url": "https:\/\/files.homerun.co\/job_application\/123\/file_pq3Zu1tYlb7LfeTbRU2N\/file.pdf?key=4f4c0af511c6958dds9c8359763718d1ae17e987dc2b2ecwaeb5779d23829384"
}

Create a new file.

To upload a file to Homerun, you’ll need to send a multipart/form-data request.

Arguments  
file required The file to upload.

Delete a file

Definition

DELETE https://api.homerun.co/v1/applications/{id}/files/{fileId}

Example Request

$ curl "https://api.homerun.co/v1/applications/ap_uP6L6sHDibDQmY8Sh52O/files/file_pq3Zu1tYlb7LfeTbRU2N" \
    -X DELETE \
    -u "YOUR_API_KEY:"

Example Response

{
  "id": "file_pq3Zu1tYlb7LfeTbRU2N",
  "filename": "file.pdf",
  "url": "https:\/\/files.homerun.co\/job_application\/123\/file_pq3Zu1tYlb7LfeTbRU2N\/resume.pdf?key=4f4c0af511c6958dds9c8359763718d1ae17e987dc2b2ecwaeb5779d23829384"
}

Delete an existing file.

List all files

Definition

GET https://api.homerun.co/v1/applications/{id}/files

Example Request

$ curl "https://api.homerun.co/v1/applications/ap_uP6L6sHDibDQmY8Sh52O/files" \
    -u "YOUR_API_KEY:"

Example Response

[
  {
    "id": "file_pq3Zu1tYlb7LfeTbRU2N",
    "filename": "resume.pdf",
    "url": "https:\/\/files.homerun.co\/job_application\/123\/file_pq3Zu1tYlb7LfeTbRU2N\/resume.pdf?key=4f4c0af511c6958dds9c8359763718d1ae17e987dc2b2ecwaeb5779d23829384"
  },
  {
    "id": "file_Ai1UsMGI88ZVjDCRFEw7",
    "filename": "coverletter.pdf",
    "url": "https:\/\/files.homerun.co\/job_application\/123\/file_Ai1UsMGI88ZVjDCRFEw7\/coverletter.pdf?key=53fb99d11eed6fd43ud6a21bf45b2bf5e7266357f8fxa2a7f90e5b491f578373"
  }
]

List all files of an application.

Candidates

The candidate object

Example Response

{
  "id": "ca_pLgKO7T4wwmBXgYGfpss",
  "applications": [
    "ap_uP6L6sHDibDQmY8Sh52O"
  ],
  "created_at": 1487835353,
  "email": "marc@smith.co",
  "first_name": "Marc",
  "last_name": "Smith",
  "most_recent_photo": "https://d2zr9w65gdacs9.cloudfront.net/53/14da63a1435155015.jpg"
}
Attributes  
id string Unique ID of the object.
applications list List of applications that belong to the candidate.

created_at timestamp Time on which the candidate was created.
email string The email address of the candidate.
first_name string The first name of the candidate.
last_name string The last name of the candidate.
most_recent_photo string The most recent photo of the candidate.

Create a candidate

Definition

POST https://api.homerun.co/v1/candidates

Example Request

$ curl "https://api.homerun.co/v1/candidates" \
    -u "YOUR_API_KEY:" \
    -d "first_name=Marc" \
    -d "last_name=Smith" \
    -d "email=marc@smith.co"

Example Response

{
  "id": "ca_pLgKO7T4wwmBXgYGfpss",
  "applications": [],
  "created_at": 1487835353,
  "email": "marc@smith.co",
  "first_name": "Marc",
  "last_name": "Smith",
  "most_recent_photo": null
}

Create a new candidate.

Note that candidates are considered to be unique by the combination of their first_name, last_name and email attributes.

If the provided candidate already exists, the most_recent_photo attribute will be updated (if set) and the response code will be set to 200 instead of 201.

Arguments  
first_name required The first name of the candidate.
last_name required The last name of the candidate.
email optional The email address of the candidate.
most_recent_photo optional URL of the photo of the candidate.

Retrieve a candidate

Definition

GET https://api.homerun.co/v1/candidates/{id}

Example Request

$ curl "https://api.homerun.co/v1/candidates/ca_pGIMQgRcwO3jaBzygcq3?expand[]=applications.job" \
    -u "YOUR_API_KEY:" \
    -G

Example Response

{
  "id": "ca_pLgKO7T4wwmBXgYGfpss",
  "applications": [
    {
      "id": "ap_uP6L6sHDibDQmY8Sh52O",
      "created_at": 1487835353,
      "disqualified": false,
      "job": {
        "id": "job_jfGhv8FnurJalJTmp8I1",
        "active_time": [
          {
            "opened_at": 1487596923,
            "closed_at": null
          }
        ],
        "application_form_url": "https://agency.homerun.co/account-manager/apply",
        "created_at": 1487595603,
        "job_url": "https://agency.homerun.co/account-manager",
        "share_image_url": null,
        "status": "open",
        "title": "Account Manager",
        "tmp_department": null,
        "tmp_location": "Amsterdam",
        "total_candidate_count": 36,
        "type": "Full-time"
      },
      "personal_info": {
        "city": "Rotterdam",
        "country": "The Netherlands",
        "date_of_birth": "1983-01-28",
        "phone_number": "012-34567890",
        "photo": "https://d2zr9w65gdacs9.cloudfront.net/53/14da63a1435155015.jpg"
      },
      "rating": 2.5,
      "rejected": false,
      "sourced": false,
      "total_votes": 2
    }
  ],
  "created_at": 1487835353,
  "email": "marc@smith.co",
  "first_name": "Marc",
  "last_name": "Smith",
  "most_recent_photo": "https://d2zr9w65gdacs9.cloudfront.net/53/14da63a1435155015.jpg"
}

Retrieve the specified candidate.

Arguments  
id required The ID of the candidate to retrieve.

Update a candidate

Definition

PUT https://api.homerun.co/v1/candidates/{id}

Example Request

$ curl "https://api.homerun.co/v1/candidates/ca_pLgKO7T4wwmBXgYGfpss" \
    -X PUT \
    -u "YOUR_API_KEY:" \
    -d "first_name=Marc" \
    -d "last_name=Smith" \
    -d "email=marc@smith.co"

Example Response

{
  "id": "ca_pLgKO7T4wwmBXgYGfpss",
  "applications": [],
  "created_at": 1487835353,
  "email": "marc@smith.co",
  "first_name": "Marc",
  "last_name": "Smith",
  "most_recent_photo": null
}

Update an existing candidate.

Note that candidates are considered to be unique by the combination of their first_name, last_name and email attributes.

If the provided candidate already exists, an error will be returned containing the ID of the existing candidate. You can use this ID to perform a merge of the candidates.

Arguments  
id required The ID of the candidate to update.
first_name optional The first name of the candidate.
last_name optional The last name of the candidate.
email optional The email address of the candidate.
most_recent_photo optional URL of the photo of the candidate.

Merge two candidates

Definition

POST https://api.homerun.co/v1/candidates/merge

Example Request

$ curl "https://api.homerun.co/v1/candidates/merge" \
    -u "YOUR_API_KEY:" \
    -d "from=ca_z3uhcqEjpgCMIU2GsULh" \
    -d "into=ca_pLgKO7T4wwmBXgYGfpss"

Example Response

{
  "id": "ca_pLgKO7T4wwmBXgYGfpss",
  "applications": [
    "ap_uP6L6sHDibDQmY8Sh52O",
    "ap_b5mVNWjdRsB5keI6DkpN"
  ],
  "created_at": 1487835353,
  "email": "marc@smith.co",
  "first_name": "Marc",
  "last_name": "Smith",
  "most_recent_photo": null
}

You can merge two candidate into one. The values retained for the first_name, last_name and email fields will be that of the candidate specified in into.

Any applications of the candidate specified in from will be transfered to the candidate specified in into.

Arguments  
from required The ID of the candidate you want to merge data from.
into required The ID of the candidate you want to merge data into.

List all candidates

Definition

GET https://api.homerun.co/v1/candidates

Example Request

$ curl "https://api.homerun.co/v1/candidates" \
    -u "YOUR_API_KEY:"

Example Response

{
  "data": [
    {
      "id": "ca_pLgKO7T4wwmBXgYGfpss",
      "applications": [
        "ap_uP6L6sHDibDQmY8Sh52O"
      ],
      "created_at": 1487835353,
      "email": "marc@smith.co",
      "first_name": "Marc",
      "last_name": "Smith",
      "most_recent_photo": "https://d2zr9w65gdacs9.cloudfront.net/53/14da63a1435155015.jpg"
    }
  ],
  "has_more": false
}

You can list all candidates, or list the candidates from a specific job. The candidates are sorted by application/source date, with the most recently created candidates appearing first.

Arguments  
job optional If set, only candidates that applied for this job will be returned.

Jobs

The job object

Example Response

{
  "id": "job_OHfvy0C4NBnJ5UCoQkaV",
  "active_time": [
    {
      "opened_at": 1401379882,
      "closed_at": null
    }
  ],
  "application_form_url": "https://agency.homerun.co/marketing-manager/apply",
  "created_at": 1401374763,
  "job_url": "https://agency.homerun.co/marketing-manager",
  "share_image_url": "https://d2zr9w65gdacs9.cloudfront.net/53/photo-1465657031025-5c9e77ddf9ca1469458947full-width.jpg",
  "status": "open",
  "title": "Marketing Manager",
  "tmp_department": null,
  "tmp_location": "Amsterdam",
  "total_candidate_count": 36,
  "type": "Full-time"
}
Attributes  
id string Unique ID of the object.
active_time list List of opened_at and closed_at timestamps, indicating when the job was opened and closed.
application_form_url string URL of the application form.
created_at timestamp Time on which the job was created.
job_url string URL of the job.
share_image_url string URL of the share image (for use on social media).
status string Current status of the job. Value can be draft, open, private or closed.
title string Title of the job.
tmp_department string Temporary attribute holding the department.
tmp_location string Temporary attribute holding the location.
type string Job type.

List all jobs

Definition

GET https://api.homerun.co/v1/jobs

Example Request

$ curl "https://api.homerun.co/v1/jobs" \
    -u "YOUR_API_KEY:"

Example Response

{
  "data": [
    {
      "id": "job_OHfvy0C4NBnJ5UCoQkaV",
      "active_time": [
        {
          "opened_at": 1401379882,
          "closed_at": null
        }
      ],
      "application_form_url": "https://agency.homerun.co/marketing-manager/apply",
      "created_at": 1401374763,
      "job_url": "https://agency.homerun.co/marketing-manager",
      "share_image_url": "https://d2zr9w65gdacs9.cloudfront.net/53/photo-1465657031025-5c9e77ddf9ca1469458947full-width.jpg",
      "status": "open",
      "title": "Marketing Manager",
      "tmp_department": null,
      "tmp_location": "Amsterdam",
      "total_candidate_count": 36,
      "type": "Full-time"
    }
  ],
  "has_more": false
}

You can list all jobs, or list the jobs with a specific status. The jobs are returned sorted by creation date, with the most recently created jobs appearing first.

Arguments  
status optional, default is open,private Only jobs with this status will be returned. Value can be draft, open, private or closed. To combine two or more statuses, separate them with commas.