List job postings

GET

/api/v1/external/job-postings

const url = 'https://app.dover.com/api/v1/external/job-postings';
const options = {method: 'GET', headers: {Authorization: '<Authorization>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://app.dover.com/api/v1/external/job-postings \
  --header 'Authorization: <Authorization>'

List jobs published to your Dover careers page. Use this for an index or a “more jobs” section on a custom careers site. Authenticate from your backend with Authorization: Bearer <API_KEY>. Do not put the key in browser JavaScript.

Authorizations

Bearer JWT

Parameters

Query Parameters

limit

integer

Number of results to return per page.

offset

integer

The initial index from which to return the results.

Responses

200

application/json

object

count

required

integer

next

string format: uri

previous

string format: uri

results

required

Array<object>

object

required

string format: uuid

title

required

Title

string

>= 1 characters

locations

Array<object>

object

location_type

required

Location type

string

Allowed values: REMOTE IN_OFFICE HYBRID

location_option

object

string format: uuid

display_name

required

Display name

string

>= 1 characters

location_type

required

Location type

string

Allowed values: CITY COUNTRY REGION ADMIN_1

city

required

City

string

>= 1 characters

state

required

State

string

>= 1 characters

country

required

Country

string

>= 1 characters

location_option_id

required

Location option id

string format: uuid

name

required

Name

string

>= 1 characters <= 255 characters

is_primary

Is primary

boolean

workplace_type

Workplace type

string

>= 1 characters

apply_url

Apply url

string format: uri

>= 1 characters

Example

{
  "results": [
    {
      "locations": [
        {
          "location_type": "REMOTE",
          "location_option": {
            "location_type": "CITY"
          }
        }
      ]
    }
  ]
}