Get Jobs - Bindbee Docs

GET

api

ats

jobs

curl --request GET \
  --url https://api.bindbee.dev/api/ats/v1/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'x-connector-token: <x-connector-token>'

{
  "cursor": "MDE4YjE4ZWYtYzk5Yy03YTg2LTk5NDYtN2I3YzlkNTQzM2U1",
  "page_size": 50,
  "items": [
    {
      "id": "018b18ef-c487-703c-afd9-0ca478ccd9d6",
      "remote_id": "123321",
      "modified_at": "2021-10-16T00:00:00Z",
      "raw_data": {
        "key_1": "Platform dependent data 1",
        "key_2": "Platform dependent data 2"
      },
      "custom_fields": {
        "category_group": "REG",
        "disability_type": "ASBERG",
        "hire_date": "1991-03-16T00:00:00",
        "hire_source": "REFER",
        "nationality": "USA",
        "original_hire_date": "1991-03-16T00:00:00"
      },
      "name": "SOFTWARE ENGINEER",
      "description": "We are looking for a software engineer to join our team.",
      "code": "SE-2021-01",
      "status": "OPEN",
      "job_posting_urls": [
        "https://www.company.com/careers/software-engineer"
      ],
      "remote_created_at": "2021-01-01T00:00:00Z",
      "remote_updated_at": "2021-01-01T00:00:00Z",
      "confidential": false,
      "departments": [
        "018b4bfb-5ece-70b1-ad5e-862a9433aa65",
        "018b4bfb-5ece-70b1-ad5e-862a9433aa23"
      ],
      "offices": [
        "018b4bfb-5ece-70b1-ad5e-862a9433aa65",
        "018b4bfb-5ece-70b1-ad5e-862a9433aa23"
      ],
      "hiring_managers": [
        "018b4bfb-5ece-70b1-ad5e-862a9433aa65",
        "018b4bfb-5ece-70b1-ad5e-862a9433aa23"
      ],
      "recruiters": [
        "018b4bfb-5ece-70b1-ad5e-862a9433aa65"
      ]
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-connector-token

string

required

Query Parameters

remote_id

string

The third-party API ID of the matching object.

code

string

If provided, will return jobs with this code

status

enum<string>

If provided, will return jobs with this status

Available options:

OPEN,

CLOSED,

DRAFT,

ARCHIVED,

PENDING,

-

offices

string[]

If provided, will return jobs in these offices

include_raw_data

boolean

default:false

Include raw data in the response

include_custom_fields

boolean

default:false

Whether to include custom fields in the response.

page_size

integer

default:50

Number of results to return per page. Maximum size is 100.

Required range: 1 <= x <= 1000

cursor

string

The pagination cursor value.

modified_after

string

If provided, only objects synced by Bindbee after this date time will be returned. Format: DateTime (ISO 8601)

expand

string

Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces. You can also specify required fields in [] for each relation name.

Response

200

application/json

Successful Response

cursor

string | null

required

Cursor value to fetch next set of items

Example:

"MDE4YjE4ZWYtYzk5Yy03YTg2LTk5NDYtN2I3YzlkNTQzM2U1"

page_size

integer

required

Indicates the count of items in the response

Example:

50

items

object[]

required

The AtsJob object represents a job posting within the ATS.

items.id

string

required

Example:

"018b18ef-c487-703c-afd9-0ca478ccd9d6"

items.remote_id

string | null

required

The third-party API ID of the matching object.

Example:

"123321"

items.modified_at

string

required

This is the datetime that this object was last updated by Bindbee

Example:

"2021-10-16T00:00:00Z"

items.custom_fields

object | null

required

The custom fields related to the model

Example:

{
  "category_group": "REG",
  "disability_type": "ASBERG",
  "hire_date": "1991-03-16T00:00:00",
  "hire_source": "REFER",
  "nationality": "USA",
  "original_hire_date": "1991-03-16T00:00:00"
}

items.name

string | null

required

The name of the job.

Example:

"SOFTWARE ENGINEER"

items.description

string | null

required

A detailed description of the job.

Example:

"We are looking for a software engineer to join our team."

items.code

string | null

required

The internal or external code that identifies the job.

Example:

"SE-2021-01"

items.status

string | null

required

The current status of the job posting.

Example:

"OPEN"

items.job_posting_urls

object[] | null

required

A list of URLs where the job is posted.

Example:

[
  "https://www.company.com/careers/software-engineer"
]

items.remote_created_at

string | null

required

The ISO date string when the job was first created in the ATS.

Example:

"2021-01-01T00:00:00Z"

items.remote_updated_at

string | null

required

The ISO date string when the job was last updated in the ATS.

Example:

"2021-01-01T00:00:00Z"

items.confidential

boolean | null

required

Whether the job posting is confidential.

Example:

false

items.departments

any[] | null

required

A list of department identifiers associated with the job.

Example:

[
  "018b4bfb-5ece-70b1-ad5e-862a9433aa65",
  "018b4bfb-5ece-70b1-ad5e-862a9433aa23"
]

items.offices

any[] | null

required

A list of office identifiers where the job is located.

Example:

[
  "018b4bfb-5ece-70b1-ad5e-862a9433aa65",
  "018b4bfb-5ece-70b1-ad5e-862a9433aa23"
]

items.hiring_managers

any[] | null

required

A list of identifiers for hiring managers associated with the job.

Example:

[
  "018b4bfb-5ece-70b1-ad5e-862a9433aa65",
  "018b4bfb-5ece-70b1-ad5e-862a9433aa23"
]

items.recruiters

any[] | null

required

A list of identifiers for recruiters associated with the job.

Example:

["018b4bfb-5ece-70b1-ad5e-862a9433aa65"]

items.raw_data

object | null

This is the Raw data

Example:

{
  "key_1": "Platform dependent data 1",
  "key_2": "Platform dependent data 2"
}

Get Job Interview Stage By Id Create Job

curl --request GET \
  --url https://api.bindbee.dev/api/ats/v1/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'x-connector-token: <x-connector-token>'

{
  "cursor": "MDE4YjE4ZWYtYzk5Yy03YTg2LTk5NDYtN2I3YzlkNTQzM2U1",
  "page_size": 50,
  "items": [
    {
      "id": "018b18ef-c487-703c-afd9-0ca478ccd9d6",
      "remote_id": "123321",
      "modified_at": "2021-10-16T00:00:00Z",
      "raw_data": {
        "key_1": "Platform dependent data 1",
        "key_2": "Platform dependent data 2"
      },
      "custom_fields": {
        "category_group": "REG",
        "disability_type": "ASBERG",
        "hire_date": "1991-03-16T00:00:00",
        "hire_source": "REFER",
        "nationality": "USA",
        "original_hire_date": "1991-03-16T00:00:00"
      },
      "name": "SOFTWARE ENGINEER",
      "description": "We are looking for a software engineer to join our team.",
      "code": "SE-2021-01",
      "status": "OPEN",
      "job_posting_urls": [
        "https://www.company.com/careers/software-engineer"
      ],
      "remote_created_at": "2021-01-01T00:00:00Z",
      "remote_updated_at": "2021-01-01T00:00:00Z",
      "confidential": false,
      "departments": [
        "018b4bfb-5ece-70b1-ad5e-862a9433aa65",
        "018b4bfb-5ece-70b1-ad5e-862a9433aa23"
      ],
      "offices": [
        "018b4bfb-5ece-70b1-ad5e-862a9433aa65",
        "018b4bfb-5ece-70b1-ad5e-862a9433aa23"
      ],
      "hiring_managers": [
        "018b4bfb-5ece-70b1-ad5e-862a9433aa65",
        "018b4bfb-5ece-70b1-ad5e-862a9433aa23"
      ],
      "recruiters": [
        "018b4bfb-5ece-70b1-ad5e-862a9433aa65"
      ]
    }
  ]
}

Unified Models

Authorizations

Headers

Query Parameters

Response