GET /api/applications — List All Job Applications

Retrieve all job applications belonging to the authenticated user. Results are ordered with the most recently created application first.

Endpoint

GET /api/applications

This endpoint requires authentication. Include a valid Bearer token in the Authorization header of every request.

The JobApplication model defines a scopeFilter scope that supports filtering by status, company, from, and to. However, the current index() controller implementation calls JobApplication::latest()->get() directly and does not apply this scope. All applications belonging to the authenticated user are returned regardless of any query parameters sent.

Example Request

curl https://your-domain.com/api/applications \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

Response

200 OK

Returns a JSON object with a data array containing all matching job application resources.

{
  "data": [
    {
      "id": 1,
      "user_id": 1,
      "company_name": "Acme Corp",
      "position_title": "Backend Developer",
      "status": "applied",
      "source": "LinkedIn",
      "source_url": "https://linkedin.com/jobs/123",
      "salary_min": 50000,
      "salary_max": 70000,
      "location": "Remote",
      "notes": "Promising role.",
      "applied_at": "2024-05-01T00:00:00.000000Z",
      "next_step_at": null,
      "created_at": "2024-05-01T10:00:00.000000Z",
      "updated_at": "2024-05-01T10:00:00.000000Z"
    }
  ]
}

data

array

required

An array of job application objects. Empty array [] if the user has no applications.

Show Application object fields

integer

Unique identifier for the job application.

user_id

integer

ID of the authenticated user who owns this application.

company_name

string

Name of the company the user applied to.

position_title

string

Job title or role applied for.

status

string

Current status of the application. One of: applied, interview, offer, rejected.

source

string | null

Platform or channel where the job was found (e.g., "LinkedIn", "Indeed").

source_url

string | null

URL to the original job posting.

salary_min

integer | null

Minimum expected salary for the role.

salary_max

integer | null

Maximum expected salary for the role.

location

string | null

Geographic location of the role (e.g., "Remote", "New York, NY").

notes

string | null

Free-text notes about the application.

applied_at

string | null

ISO 8601 datetime representing when the application was submitted.

next_step_at

string | null

ISO 8601 datetime for the next scheduled step, such as an interview or deadline.

created_at

string

ISO 8601 datetime when this record was created in the system.

updated_at

string

ISO 8601 datetime when this record was last modified.

401 Unauthorized

Returned when the Authorization header is missing or the token is invalid.

{
  "message": "Unauthenticated."
}

Authentication

Job Applications

Statistics

GET /api/applications — List All Job Applications

Endpoint

Example Request

Response

200 OK

401 Unauthorized

Build docs developers (and LLMs) love

Authentication

Job Applications

Statistics

Documentation Index

​Endpoint

​Example Request

​Response

​200 OK

​401 Unauthorized

Build docs developers (and LLMs) love

Endpoint

Example Request

Response

200 OK

401 Unauthorized