# Approve a held application (/docs/reference/applications-id/approve)

`POST https://api.getmattered.com/api/v1/developer/applications/{id}/approve`

Needs a key made with the `apply` scope. Approves an application in `held_for_review` and sends it, the way the account owner approves it in GetMattered. An application GetMattered cannot send stays held or ends `not_landed`; the answer is its state after the approval. An application started in GetMattered is paid by the app plan, one started by API by the API balance. Free.

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

## Parameters

- `id` (path, required): The application id `POST /developer/apply` answered with.

## Responses

### 200: The application after the approval.

```json
{
  "type": "object",
  "properties": {
    "data": {
      "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
    },
    "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

### 403: Forbidden

### 404: Not Found

### 409: Conflict

### 429: Too Many Requests

### 500: Internal Server Error

Error responses use the envelope in /errors.md.