Jobs API

List owned jobs

This endpoint is only available to employers

List all jobs created by you.

GET /me/jobs

List all jobs

List all jobs across all users.

GET /jobs

Parameters

sort
created_at, updated_at, title, default: created_at.
direction
asc or desc, default: desc

List employer jobs

List jobs owned by the specified employer.

GET /employers/:employer_id/jobs

Parameters

sort
created_at, default: created_at.
direction
asc or desc, default: desc

List nearby jobs

GET /jobs/:latitude/:longitude

Parameters

sort
created_at, updated_at, title, default: created_at.
direction
asc or desc, default: desc

Response

Status: 200 OK
Link: <https://tapability.org/api/v1/resource?page=2>; rel="next",
      <https://tapability.org/api/v1/resource?page=5>; rel="last"
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
[
  {
    "id": "a3338736-ffcd-472e-9b82-b7ca38eaa355",
    "title": "Assistant Regional Manager",
    "category_name": "Sales",
    "description": "Actually, it's Assistant TO the Regional Manager",
    "city": "Scranton",
    "state": "Pennsylvania",
    "api_url": "https://tapability.org/api/v1/jobs/a3338736-ffcd-472e-9b82-b7ca38eaa355",
    "html_url": "https://tapability.org/jobs/a3338736-ffcd-472e-9b82-b7ca38eaa355",
    "created_at": "2012-12-09T17:58:26Z",
    "updated_at": "2012-12-09T17:58:26Z",
    "expires_at": "2013-02-09T17:58:26Z",
    "expired": false,
    "employer": {
      "id": "38075a53-a470-4654-a4e6-4d67c2207b35",
      "name": "Dunder Miflin",
      "api_url": "https://tapability.org/api/v1/employers/38075a53-a470-4654-a4e6-4d67c2207b35",
      "website_url": "http://www.dundermiflin.com"
    },
    "coordinates": [
      32.7993,
      -117.16
    ]
  }
]

Get a single job

GET /jobs/:job_id

Response

Status: 200 OK
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
{
  "id": "a3338736-ffcd-472e-9b82-b7ca38eaa355",
  "title": "Assistant Regional Manager",
  "category_name": "Sales",
  "description": "Actually, it's Assistant TO the Regional Manager",
  "city": "Scranton",
  "state": "Pennsylvania",
  "api_url": "https://tapability.org/api/v1/jobs/a3338736-ffcd-472e-9b82-b7ca38eaa355",
  "html_url": "https://tapability.org/jobs/a3338736-ffcd-472e-9b82-b7ca38eaa355",
  "created_at": "2012-12-09T17:58:26Z",
  "updated_at": "2012-12-09T17:58:26Z",
  "expires_at": "2013-02-09T17:58:26Z",
  "expired": false,
  "employer": {
    "id": "38075a53-a470-4654-a4e6-4d67c2207b35",
    "name": "Dunder Miflin",
    "api_url": "https://tapability.org/api/v1/employers/38075a53-a470-4654-a4e6-4d67c2207b35",
    "website_url": "http://www.dundermiflin.com"
  },
  "coordinates": [
    32.7993,
    -117.16
  ],
  "street1": null,
  "street2": null,
  "zip": null,
  "contact_name": null,
  "contact_email": null,
  "contact_phone": null,
  "full_time": false,
  "part_time": false,
  "internship": false,
  "volunteer": false,
  "contract": false,
  "temporary": false,
  "telecommute": false
}

Create a job

This endpoint is only available to employers

Create a new job for the authenticated user.

POST /jobs

Input

title
Required string
description
Required string
category_name
Required string - must be a valid category name, full list available in the Categories API
code
Required string
street1
Optional string
street2
Optional string
city
Required string
state
Required string
zip
Optional string
coordinates
Optional array - must contain valid latitude and longitude as floats
apply_url
Required string
full_time
Optional boolean
part_time
Optional boolean
internship
Optional boolean
volunteer
Optional boolean
contract
Optional boolean
temporary
Optional boolean
telecommute
Optional boolean 
{
  "code": "MIFLIN0001",
  "title": "Assistant Regional Manager",
  "description": "Actually, it's Assistant TO the Regional Manager",
  "category_name": "Sales",
  "city": "Scranton",
  "state": "Pennsylvania",
  "coordinates": [
    32.7993,
    -117.16
  ],
  "apply_url": "http://www.dundermiflin.com/jobs/arm"
}

Response

Status: 201 Created
Location: https://tapability.org/api/v1/jobs/a3338736-ffcd-472e-9b82-b7ca38eaa355
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
{
  "id": "a3338736-ffcd-472e-9b82-b7ca38eaa355",
  "title": "Assistant Regional Manager",
  "category_name": "Sales",
  "description": "Actually, it's Assistant TO the Regional Manager",
  "city": "Scranton",
  "state": "Pennsylvania",
  "api_url": "https://tapability.org/api/v1/jobs/a3338736-ffcd-472e-9b82-b7ca38eaa355",
  "html_url": "https://tapability.org/jobs/a3338736-ffcd-472e-9b82-b7ca38eaa355",
  "created_at": "2012-12-09T17:58:26Z",
  "updated_at": "2012-12-09T17:58:26Z",
  "expires_at": "2013-02-09T17:58:26Z",
  "expired": false,
  "employer": {
    "id": "38075a53-a470-4654-a4e6-4d67c2207b35",
    "name": "Dunder Miflin",
    "api_url": "https://tapability.org/api/v1/employers/38075a53-a470-4654-a4e6-4d67c2207b35",
    "website_url": "http://www.dundermiflin.com"
  },
  "coordinates": [
    32.7993,
    -117.16
  ],
  "street1": null,
  "street2": null,
  "zip": null,
  "contact_name": null,
  "contact_email": null,
  "contact_phone": null,
  "full_time": false,
  "part_time": false,
  "internship": false,
  "volunteer": false,
  "contract": false,
  "temporary": false,
  "telecommute": false,
  "code": "MIFLIN0001",
  "deleted": false,
  "deleted_at": null
}

Update a job

This endpoint is only available to employers

Update the provided job.

PATCH /jobs/:job_id

Input

Note: you cannot update job category or location info when updating.

title
Required string
description
Required string
code
Required string
apply_url
Required string
full_time
Optional boolean
part_time
Optional boolean
internship
Optional boolean
volunteer
Optional boolean
contract
Optional boolean
temporary
Optional boolean
telecommute
Optional boolean 
{
  "code": "MIFLIN0001",
  "title": "Assistant Regional Manager",
  "description": "Actually, it's Assistant TO the Regional Manager",
  "apply_url": "http://www.dundermiflin.com/jobs/arm"
}

Response

Status: 200 OK
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
{
  "id": "a3338736-ffcd-472e-9b82-b7ca38eaa355",
  "title": "Assistant Regional Manager",
  "category_name": "Sales",
  "description": "Actually, it's Assistant TO the Regional Manager",
  "city": "Scranton",
  "state": "Pennsylvania",
  "api_url": "https://tapability.org/api/v1/jobs/a3338736-ffcd-472e-9b82-b7ca38eaa355",
  "html_url": "https://tapability.org/jobs/a3338736-ffcd-472e-9b82-b7ca38eaa355",
  "created_at": "2012-12-09T17:58:26Z",
  "updated_at": "2012-12-09T17:58:26Z",
  "expires_at": "2013-02-09T17:58:26Z",
  "expired": false,
  "employer": {
    "id": "38075a53-a470-4654-a4e6-4d67c2207b35",
    "name": "Dunder Miflin",
    "api_url": "https://tapability.org/api/v1/employers/38075a53-a470-4654-a4e6-4d67c2207b35",
    "website_url": "http://www.dundermiflin.com"
  },
  "coordinates": [
    32.7993,
    -117.16
  ],
  "street1": null,
  "street2": null,
  "zip": null,
  "contact_name": null,
  "contact_email": null,
  "contact_phone": null,
  "full_time": false,
  "part_time": false,
  "internship": false,
  "volunteer": false,
  "contract": false,
  "temporary": false,
  "telecommute": false,
  "code": "MIFLIN0001",
  "deleted": false,
  "deleted_at": null
}

Expire a job

This endpoint is only available to employers

Expired the provided job. This marks the job as no longer available for candidate applications.

POST /jobs/:job_id/expire

Response

Status: 200 OK
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
{
  "id": "a3338736-ffcd-472e-9b82-b7ca38eaa355",
  "title": "Assistant Regional Manager",
  "category_name": "Sales",
  "description": "Actually, it's Assistant TO the Regional Manager",
  "city": "Scranton",
  "state": "Pennsylvania",
  "api_url": "https://tapability.org/api/v1/jobs/a3338736-ffcd-472e-9b82-b7ca38eaa355",
  "html_url": "https://tapability.org/jobs/a3338736-ffcd-472e-9b82-b7ca38eaa355",
  "created_at": "2012-12-09T17:58:26Z",
  "updated_at": "2012-12-09T17:58:26Z",
  "expires_at": "2012-12-18T21:41:30Z",
  "expired": true,
  "employer": {
    "id": "38075a53-a470-4654-a4e6-4d67c2207b35",
    "name": "Dunder Miflin",
    "api_url": "https://tapability.org/api/v1/employers/38075a53-a470-4654-a4e6-4d67c2207b35",
    "website_url": "http://www.dundermiflin.com"
  },
  "coordinates": [
    32.7993,
    -117.16
  ],
  "street1": null,
  "street2": null,
  "zip": null,
  "contact_name": null,
  "contact_email": null,
  "contact_phone": null,
  "full_time": false,
  "part_time": false,
  "internship": false,
  "volunteer": false,
  "contract": false,
  "temporary": false,
  "telecommute": false,
  "code": "MIFLIN0001",
  "deleted": false,
  "deleted_at": null
}

Delete a job

This endpoint is only available to employers

Delete the provided job.

DELETE /jobs/:job_id

Response

Status: 204 No Content
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999