# List applications (/docs/reference/applications)

`GET https://api.getmattered.com/api/v1/developer/applications`

Your applications, newest first, with the same states as `GET /developer/applications/{id}`. Filter by `status` and `since`; page with `cursor`. Free.

Authentication: `Authorization: Bearer gm_live_...` (see /authentication.md).

## Parameters

- `cursor` (query): The `nextCursor` of the page before. Omit it for the newest applications.

- `limit` (query): Applications per page, 1 to 50.

- `since` (query): Only applications started at or after this instant, ISO 8601.

- `status` (query): Only applications in this state. A filtered page may hold fewer items than `limit`; keep paging while `nextCursor` is not null.

## Responses

### 200: One page of applications and the cursor for the next.

```json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "applications": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "company": {
                "type": [
                  "string",
                  "null"
                ],
                "example": "Acme"
              },
              "id": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "description": "The application. The same posting always answers with the same id.",
                "example": 2481
              },
              "jobTitle": {
                "type": [
                  "string",
                  "null"
                ],
                "example": "Senior Frontend Engineer"
              },
              "landedEvidence": {
                "type": "array",
                "items": {
                  "type": "string",
                  "enum": [
                    "receipt",
                    "screenshot"
                  ],
                  "description": "Who authored the evidence that this application reached the employer. `receipt` = the employer emailed a confirmation linked to this row. `screenshot` = a review of the stored post-submit screenshot read the employer's OWN confirmation page. Both are the other side's answer and both count as a proven landing; a row may hold either or both.",
                  "example": "screenshot"
                },
                "description": "The employer's own proof the application landed: `receipt` (their email) and `screenshot` (their confirmation page). Empty unless `status` is `landed`.",
                "example": [
                  "receipt"
                ]
              },
              "postingUrl": {
                "type": [
                  "string",
                  "null"
                ],
                "example": "https://job-boards.greenhouse.io/acme/jobs/4012345"
              },
              "status": {
                "type": "string",
                "enum": [
                  "in_progress",
                  "held_for_review",
                  "needs_you",
                  "landed",
                  "held",
                  "not_landed"
                ],
                "description": "`in_progress`: GetMattered is preparing or sending it, or it was sent and the employer has not confirmed it yet. `held_for_review`: ready, and waiting for the account owner to approve it in GetMattered. `needs_you`: waiting on the account owner for something else. `landed`: the employer confirmed it, by their own email or their confirmation page; `landedEvidence` says which. `held`: it stopped, and a mail may be the employer's answer, so GetMattered will not send it again; do not retry. `not_landed`: it stopped without the employer confirming it. Calling apply again for a stopped posting sends it again, except a `held` one or one the owner cancelled.",
                "example": "in_progress"
              },
              "tokens": {
                "type": "integer",
                "description": "Tokens the call that started this application has spent on it so far, the request fee included. 0 for an application started in GetMattered.",
                "example": 22130
              },
              "trackingUrl": {
                "type": "string",
                "format": "uri",
                "description": "The application's page in GetMattered, behind the account owner's sign-in.",
                "example": "https://getmattered.com/dashboard/applications/2481"
              }
            },
            "required": [
              "company",
              "id",
              "jobTitle",
              "landedEvidence",
              "postingUrl",
              "status",
              "tokens",
              "trackingUrl"
            ],
            "additionalProperties": false
          }
        },
        "nextCursor": {
          "type": [
            "integer",
            "null"
          ],
          "exclusiveMinimum": 0,
          "description": "Pass it as `cursor` for the next, older page. Null when nothing older is left.",
          "example": 2461
        }
      },
      "required": [
        "applications",
        "nextCursor"
      ],
      "additionalProperties": false
    },
    "meta": {
      "type": "object",
      "properties": {
        "duration": {
          "type": "number",
          "minimum": 0,
          "description": "Request duration in milliseconds",
          "example": 150
        },
        "performance": {
          "type": "object",
          "properties": {
            "dbQueries": {
              "type": "integer",
              "minimum": 0
            },
            "totalDbTime": {
              "type": "number",
              "minimum": 0
            }
          },
          "description": "Performance metrics (preview/local only)"
        },
        "requestId": {
          "type": "string",
          "description": "Unique request identifier",
          "example": "req_abc123"
        },
        "timestamp": {
          "type": "string",
          "format": "date-time",
          "description": "ISO 8601 timestamp",
          "example": "2026-11-17T12:00:00.000Z"
        },
        "version": {
          "type": "string",
          "description": "API version",
          "example": "v1"
        }
      }
    },
    "success": {
      "type": "boolean",
      "enum": [
        true
      ]
    }
  },
  "required": [
    "data",
    "success"
  ],
  "additionalProperties": false,
  "description": "Successful API response"
}
```

### 400: Bad Request

### 401: Unauthorized

### 404: Not Found

### 429: Too Many Requests

### 500: Internal Server Error

Error responses use the envelope in /errors.md.