Retrieve a list of ATS job boards | Deel

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
      "type_enum": "INTERNAL_CAREER_PAGE",
      "created_at": "2024-01-15T10:30:00.000Z",
      "updated_at": "2024-02-01T12:00:00.000Z",
      "status_enum": "ENABLED",
      "settings_json": {
        "company_id": "12345678"
      },
      "career_page_setting": {
        "id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
        "title": "Join Our Team",
        "url_slug": "company-careers",
        "is_primary": true,
        "description": "We are looking for talented individuals",
        "organization_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
        "banner_image_url": "https://example.com/banner.jpg",
        "should_show_logo": true,
        "dark_mode_logo_url": "https://example.com/logo-dark.png",
        "light_mode_logo_url": "https://example.com/logo-light.png",
        "should_show_job_filters": true,
        "preferred_organization_name": "Company Name",
        "dark_mode_color_primary_hexcode": "#3399FF",
        "light_mode_color_primary_hexcode": "#0066CC",
        "should_show_banner_on_job_details_page": true
      }
    }
  ],
  "has_more": false,
  "next_cursor": "string",
  "total_count": 3
}

Retrieves job boards configured on ATS for an organization. Use this to list available boards (internal, external, or LinkedIn) before selecting one for job postings or career-page configuration.

Token scopes: ats:read, worker:read

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

$ curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.deel.training/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Query parameters

limitintegerOptional1-100Defaults to 20

Number of items to return

cursorstringOptional

Cursor for pagination

Response

Successfully retrieved job boards

datalist of objects

Page of job boards

has_moreboolean

Indicates if there are more job boards to fetch

next_cursorstring or null

Cursor for the next page of results

total_countinteger

Total number of job boards available

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -G https://api.letsdeel.com/rest/ats/job-boards \
>	-H "Authorization: Bearer <token>" \
>	-d limit=20 \
>	-d cursor=eyJpZCI6IjEyMyIsIm51bWVyaWNLZSI6NDU2fQ

$	curl -X GET 'https://api.deel.training/rest/v2/contracts' \
>	-H 'Authorization: Bearer YOUR-TOKEN-HERE'