List your jobs

GET/v1/jobs

Needs a bearer access token with the jobs.read scope. How authentication works

The jobs your application created, newest first. Filter by status, or by updated_since to pick up only what changed. external_job_id finds the job you pushed with that id.

curl -X GET "https://developer.rolefy.fit/api/v1/jobs" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

200 · A page of jobs

{
  "data": [
    {
      "id": "4c7e2b90-6d1a-4f35-a8c3-1e9b5d7f0a24",
      "external_job_id": "REQ-20458",
      "title": "Registered Nurse",
      "description": "<p>Join our team caring for residents in a modern aged care home.</p>",
      "job_type": "full_time",
      "work_model": "onsite",
      "experience_level": "mid",
      "category_id": "7a1c3e5f-9b2d-4f68-a0c4-2e6b8d1f3a57",
      "city": "Melbourne",
      "state": "VIC",
      "country": "Australia",
      "salary_min": 85000,
      "salary_max": 98000,
      "salary_currency": "AUD",
      "salary_period": "annual",
      "status": "active",
      "expires_at": "2026-06-30",
      "applications_count": 12,
      "public_url": "https://rolefy.fit/jobs?job=registered-nurse-at-sunrise-care-m1x9k2a",
      "created_at": "2026-03-14T09:30:00Z",
      "updated_at": "2026-03-15T01:10:00Z"
    }
  ],
  "total": 1
}

Query parameters

statusstringquery
Only return jobs with this status.
Allowed values:draftpending_approvalactiveexpiredclosedrejectedtaken_down
external_job_idstringquery
Only return the job pushed with this id.
updated_sincestring · date-timequery
Only return jobs changed at or after this time (ISO 8601).
limitintegerquery
Page size. Default 25, maximum 100.
offsetintegerquery
How many results to skip before the first one returned. Maximum 10,000.

Responses

200A page of jobs
Response fields
- dataarray of Job
  idstring · uuid
  external_job_idstringnullable
  Your own id for this job.
  titlestring
  descriptionstring
  job_typestringnullable
  work_modelstringnullable
  experience_levelstringnullable
  category_idstring · uuidnullable
  citystringnullable
  statestringnullable
  countrystring
  salary_minnumbernullable
  salary_maxnumbernullable
  salary_currencystring
  salary_periodstring
  statusstring
  You can set draft, active and closed. The others are set by Rolefy.
  Allowed values:draftpending_approvalactiveexpiredclosedrejectedtaken_down
  expires_atstring · datenullable
  applications_countinteger
  public_urlstringnullable
  The job's page on Rolefy. Null for sandbox jobs.
  created_atstring · date-time
  updated_atstring · date-time
- totalinteger