> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mokaru.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Applications

> View your tracked applications

## Overview

The List Applications endpoint retrieves your tracked job applications from Mokaru. Use it to sync your application pipeline to external tools, build custom dashboards, or let an AI agent review your progress.

**Common use cases:**

* **Notion and Airtable sync** - set up an n8n or Make workflow that polls this endpoint on a schedule and upserts rows into your Notion database or Airtable base. Keep your preferred workspace in sync without manual copy-pasting.
* **Spreadsheet export** - pull all your applications into Google Sheets or Excel for custom filtering, pivot tables, or sharing with a career coach.
* **AI agent review** - let an AI agent fetch your current applications, identify stale ones (applied weeks ago with no response), and suggest follow-up actions.
* **Custom dashboards** - build a personal analytics view showing application volume by week, conversion rates by source, or salary range distribution.
* **Slack and email digests** - create a daily or weekly summary of new applications, status changes, and upcoming interviews.

You can filter results by status to focus on a specific stage of your pipeline. Use `limit` and `offset` for pagination when you have more applications than fit in a single response.

### Application Statuses

Each application has a status that reflects where it is in your pipeline:

| Status                | Description                                            |
| --------------------- | ------------------------------------------------------ |
| `watchlist`           | Saved for later - you have not applied yet             |
| `preparing`           | Actively preparing your application materials          |
| `applied`             | Application submitted and waiting for a response       |
| `response`            | You received a response from the company               |
| `screening`           | Initial screening stage (phone screen, recruiter call) |
| `interview_scheduled` | An interview has been scheduled                        |
| `interviewed`         | Interview completed, waiting for feedback              |
| `offer`               | You received a job offer                               |
| `negotiating`         | Negotiating terms or compensation                      |
| `accepted`            | You accepted an offer for this position                |
| `rejected`            | The application was rejected                           |
| `withdrawn`           | You withdrew your application                          |
| `no_response`         | No response received after a reasonable period         |

<Note>
  **Scope required:** `tracker:read` | **Rate limit:** 60 requests/min
</Note>

## Request

```bash theme={null}
GET /v1/tracker/applications
```

### Query Parameters

<ParamField query="status" type="string">
  Filter by status: `watchlist`, `preparing`, `applied`, `response`, `screening`, `interview_scheduled`, `interviewed`, `offer`, `negotiating`, `accepted`, `rejected`, `withdrawn`, `no_response`
</ParamField>

<ParamField query="limit" type="number" default="25">
  Results per page (max 100)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Pagination offset
</ParamField>

### Example

```bash theme={null}
curl "https://api.mokaru.ai/v1/tracker/applications?status=applied&limit=10" \
  -H "Authorization: Bearer mk_your_key"
```

## Response

<ResponseField name="data" type="array">
  Array of applications

  <Expandable>
    <ResponseField name="id" type="string">Application ID</ResponseField>
    <ResponseField name="jobTitle" type="string">Job title</ResponseField>
    <ResponseField name="company" type="string">Company name</ResponseField>
    <ResponseField name="location" type="string">Job location</ResponseField>
    <ResponseField name="jobUrl" type="string">Link to the job posting</ResponseField>
    <ResponseField name="status" type="string">Current status</ResponseField>
    <ResponseField name="source" type="string">Where the job was found</ResponseField>
    <ResponseField name="priority" type="number">Priority (1-5)</ResponseField>
    <ResponseField name="salaryMin" type="number">Minimum salary</ResponseField>
    <ResponseField name="salaryMax" type="number">Maximum salary</ResponseField>
    <ResponseField name="appliedDate" type="string">ISO 8601 date</ResponseField>
    <ResponseField name="createdAt" type="string">ISO 8601 date</ResponseField>
    <ResponseField name="updatedAt" type="string">ISO 8601 date</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="number">Total matching applications</ResponseField>
<ResponseField name="hasMore" type="boolean">Whether more results are available</ResponseField>
<ResponseField name="limit" type="number">Results per page</ResponseField>
<ResponseField name="offset" type="number">Current offset</ResponseField>

```json theme={null}
{
  "data": [
    {
      "id": "clx5678...",
      "jobTitle": "Senior Software Engineer",
      "company": "Acme Corp",
      "location": "San Francisco, CA",
      "jobUrl": "https://acme.com/careers/123",
      "status": "applied",
      "source": "Other",
      "priority": 3,
      "salaryMin": 150000,
      "salaryMax": 200000,
      "appliedDate": "2026-03-15T00:00:00.000Z",
      "createdAt": "2026-03-15T12:00:00.000Z",
      "updatedAt": "2026-03-15T12:00:00.000Z"
    }
  ],
  "total": 42,
  "hasMore": true,
  "limit": 25,
  "offset": 0
}
```
