List published jobs

GET

/api/public/v1/jobs

const url = 'https://api.atlasthq.com/api/public/v1/jobs?page=1&pageSize=20';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

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://api.atlasthq.com/api/public/v1/jobs?page=1&pageSize=20' \
  --header 'Authorization: Bearer <token>'

Returns a paginated list of the organisation’s published jobs. Only jobs where isPublished = true are returned. Pagination is zero-latency on empty pages (returns 200 with { data: [], total: 0 }).

Authorizations

bearer

Parameters

Query Parameters

page

number

Example

Page number (1-based, default 1, min 1)

pageSize

number

Example

Items per page (default 20, min 1, max 100)

Responses

200

Paginated list of published jobs

application/json

object

data

Array<object>

object

required

Job internal ID

string

publicId

required

URL-friendly public job identifier

string

jobTitle

required

Job title

string

location

required

Job location

string

nullable

department

required

Department

string

nullable

type

required

Employment type

string

nullable

seniorityLevel

required

Seniority level

string

nullable

minSalary

required

Minimum salary

number

nullable

maxSalary

required

Maximum salary

number

nullable

currency

required

Salary currency code

string

nullable

jobUrl

required

Public URL for the job detail page (attached by API layer)

string

nullable

applyUrl

required

Public URL for the job application form (attached by API layer)

string

nullable

page

integer

pageSize

integer

total

integer

Example

{
  "data": [
    {
      "id": "job-550e8400-e29b-41d4-a716-446655440000",
      "publicId": "abc123def456",
      "jobTitle": "Senior Software Engineer",
      "location": "San Francisco, CA",
      "department": "Engineering",
      "type": "Full-time",
      "seniorityLevel": "Senior",
      "minSalary": 80000,
      "maxSalary": 120000,
      "currency": "USD",
      "jobUrl": "https://acme.careers.atlasthq.com/jobs/abc123def456",
      "applyUrl": "https://acme.careers.atlasthq.com/jobs/abc123def456/apply"
    }
  ],
  "page": 1,
  "pageSize": 20,
  "total": 42
}

401

Missing or invalid API key

403

Organisation plan does not include the public API

429

Rate limit exceeded (60 req/min per key)