Skip to Content
Applications

Apply to a job posting

POST
/developer/apply

Needs a key made with the apply scope. Applies to one job posting for the key owner's own account, the way GetMattered applies from the app: it resolves the link to the employer's posting, prepares the application and sends it, or holds it for the owner's approval. Answers at once; read the outcome from GET /developer/applications/{id}. The same posting twice answers with the same application. A stopped application starts again, except one held or one the owner cancelled. It spends the API balance, never the app plan, and needs 40,000 API tokens there for each application in progress plus this one to start; a running application finishes even if it takes the balance below zero, and the next call is refused until a top-up. At most 5 applications started by API are in progress at once, and an account reads at most 5 postings a minute across its keys. Spends the tokens the application uses plus the request fee, recorded as apply. A call refused before the posting is read spends nothing; once the posting is read, the call pays the request fee whatever it answers.

Authorization

DeveloperKey
headerAuthorizationBearer <gm_live_...>

A GetMattered developer API key, sent as Authorization: Bearer gm_live_....

Request Body

application/json
  1. body
mode?string

auto sends once the application is ready. review holds it for the account owner to approve in GetMattered. Omitted, the account's own setting decides, and auto never overrides an account set to review.

Value in"auto""review"
postingUrl*string

The job posting to apply to: the employer's own posting, or a job-board link to it. GetMattered applies only on the hiring systems it supports.

Formaturi
Lengthlength <= 2048

Response Body

The application, started now or found from an earlier call.

application/json
  1. response

Successful API response

data*
meta?
success*true
Value intrue
Example Request
curl -X POST 'https://api.getmattered.com/api/v1/developer/apply' \  -H 'Content-Type: application/json' \  -d '{  "postingUrl": "http://example.com"}'
Example Response
{  "data": {    "id": 1,    "status": "in_progress",    "trackingUrl": "http://example.com"  },  "meta": {    "duration": 0,    "performance": {      "dbQueries": 0,      "totalDbTime": 0    },    "requestId": "string",    "timestamp": "2019-08-24T14:15:22Z",    "version": "string"  },  "success": true}