Get a single published job

GET

/api/public/v1/jobs/{publicId}

const url = 'https://api.atlasthq.com/api/public/v1/jobs/abc123def456';
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/abc123def456 \
  --header 'Authorization: Bearer <token>'

Returns the full public detail for a published job identified by its publicId. Returns 404 for unknown, unpublished, or cross-org publicId values (no existence leak).

Authorizations

bearer

Parameters

Path Parameters

publicId

required

string

Example

abc123def456

The public identifier of the job

Responses

200

Full public job detail

application/json

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

roleOverview

required

Role overview

string

nullable

keyResponsibilities

required

Key responsibilities

string

nullable

requiredSkills

required

Required skills

string

nullable

preferredQualifications

required

Preferred qualifications

string

nullable

minSalary

required

Minimum salary

number

nullable

maxSalary

required

Maximum salary

number

nullable

currency

required

Salary currency code

string

nullable

benefits

required

Benefits description

string

nullable

yearsExperience

required

Years of experience required

number

nullable

primaryLanguage

required

Primary language

string

nullable

educationLevel

required

Education level

string

nullable

workAuthorization

required

Work authorization requirements

string

nullable

knockoutQuestions

required

Knockout screening questions

Array<object>

nullable

object

required

string

question

required

string

required

required

boolean

type

required

string

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

Example

{
  "id": "job-550e8400-e29b-41d4-a716-446655440000",
  "publicId": "abc123def456",
  "jobTitle": "Senior Software Engineer",
  "location": "San Francisco, CA",
  "department": "Engineering",
  "type": "Full-time",
  "seniorityLevel": "Senior",
  "roleOverview": "We are looking for...",
  "minSalary": 80000,
  "maxSalary": 120000,
  "currency": "USD",
  "yearsExperience": 5,
  "primaryLanguage": "English",
  "educationLevel": "Bachelor's degree",
  "knockoutQuestions": [
    {
      "id": "kq-abc123",
      "question": "Do you have a valid EU work permit?",
      "required": true,
      "type": "boolean"
    }
  ],
  "jobUrl": "https://acme.careers.atlasthq.com/jobs/abc123def456",
  "applyUrl": "https://acme.careers.atlasthq.com/jobs/abc123def456/apply"
}

401

Missing or invalid API key

403

Organisation plan does not include the public API

404

Job not found, unpublished, or belongs to another organisation

429

Rate limit exceeded (60 req/min per key)