Jobiflow LogoAPI Docs
ApiApplications

List applications

Returns a paginated list of applications for your company's listings. Filter by job listing, status, date range, or candidate name. Requires scope: `applications:read`

GET
/public/v1/applications

Returns a paginated list of applications for your company's listings. Filter by job listing, status, date range, or candidate name.

Requires scope: applications:read

Authorization

ApiKeyAuth
X-API-Key<token>

API key issued by Jobiflow. Pass it in the X-API-Key request header.

Create keys via the company dashboard (Settings → API Keys) or via POST /settings/api-keys.

In: header

Query Parameters

jobListingId?string

Filter applications to a specific job listing UUID.

Formatuuid
status?array<>

Filter by one or more application statuses (repeatable query param).

appliedFrom?string

Return applications submitted on or after this timestamp (ISO 8601).

Formatdate-time
appliedTo?string

Return applications submitted on or before this timestamp (ISO 8601).

Formatdate-time
jobSeekerName?string

Filter by candidate first or last name (partial match).

query?string

Free-text search across applicant name and cover letter.

page?integer

Zero-based page index.

Default0
Formatint32
Range0 <= value
size?integer

Number of items per page (max 100).

Default20
Formatint32
Range1 <= value <= 100

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/public/v1/applications"
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "jobListingId": "a7d01775-e611-4288-b8c1-442852b8ff39",
      "jobSeekerId": "f2c64cb3-7c14-4d64-8545-215342f6c081",
      "status": "ACTIVE",
      "source": "INTERNAL",
      "appliedAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "candidate": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "firstName": "string",
        "lastName": "string",
        "headline": "string",
        "email": "user@example.com",
        "phone": "string"
      }
    }
  ],
  "pagination": {
    "page": 0,
    "size": 0,
    "totalElements": 0,
    "totalPages": 0
  }
}
{
  "status": 401,
  "error": "UNAUTHORIZED",
  "message": "Invalid or missing API key",
  "timestamp": "2026-05-17T12:00:00Z",
  "path": "/public/v1/job-listings"
}
{
  "status": 403,
  "error": "FORBIDDEN",
  "message": "Scope 'jobs:write' is required",
  "timestamp": "2026-05-17T12:00:00Z",
  "path": "/public/v1/job-listings"
}

Get analytics for a job listing GET

Returns view counts, application funnel data, and daily trend metrics for a specific job listing. Requires scope: `analytics:read`

Get an application GET

Returns detailed information about a single application, including the full job listing and candidate summary. Requires scope: `applications:read`