List applications

GET/v1/applications

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

Applications to your jobs, newest first. Filter by job_id or external_job_id, by status, or by created_since to collect only what arrived after your last pull. The list returns a short summary of each application. Fetch one by id for the candidate's full details.

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

200 · A page of application summaries

{
  "data": [
    {
      "id": "9d2e4a86-1c3b-4f57-a8e0-6b7c5d9f1a23",
      "job_id": "4c7e2b90-6d1a-4f35-a8c3-1e9b5d7f0a24",
      "external_job_id": "REQ-20458",
      "status": "submitted",
      "created_at": "2026-03-16T04:12:00Z"
    }
  ],
  "total": 1
}

Query parameters

job_idstring · uuidquery
Only applications to this job.
external_job_idstringquery
Only applications to the job pushed with this id.
statusstringquery
Only applications with this status.
Allowed values:submittedreviewingshortlistedinterviewofferedhiredrejected
created_sincestring · date-timequery
Only applications received 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 application summaries
Response fields
- dataarray of ApplicationSummary
  idstring · uuid
  job_idstring · uuid
  external_job_idstringnullable
  statusstring
  Allowed values:submittedreviewingshortlistedinterviewofferedhiredrejected
  created_atstring · date-time
- totalinteger