List applications
Your applications, newest first, with the same states as GET /developer/applications/{id}. Filter by status and since; page with cursor. Free.
DeveloperKeyAuthorizationBearer <gm_live_...>A GetMattered developer API key, sent as Authorization: Bearer gm_live_....
cursor?integerThe nextCursor of the page before. Omit it for the newest applications.
0 < valuelimit?integerApplications per page, 1 to 50.
1 <= value <= 5020since?stringOnly applications started at or after this instant, ISO 8601.
date-timestatus?stringOnly applications in this state. A filtered page may hold fewer items than limit; keep paging while nextCursor is not null.
"in_progress""held_for_review""needs_you""landed""held""not_landed"One page of applications and the cursor for the next.
application/json- response
Successful API response
data*meta?success*truetruecurl -X GET 'https://api.getmattered.com/api/v1/developer/applications'{
"data": {
"applications": [
{
"company": "string",
"id": 1,
"jobTitle": "string",
"landedEvidence": [
"receipt"
],
"postingUrl": "string",
"status": "in_progress",
"tokens": 0,
"trackingUrl": "http://example.com"
}
],
"nextCursor": 1
},
"meta": {
"duration": 0,
"performance": {
"dbQueries": 0,
"totalDbTime": 0
},
"requestId": "string",
"timestamp": "2019-08-24T14:15:22Z",
"version": "string"
},
"success": true
}Apply to a job posting POST
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.
Read an application GET
Where one of your applications stands. `landed` only when the employer confirmed it, by their own email or their confirmation page. Free.