Skip to Content
Jobs

List the candidate's matches

GET
/developer/jobs/matches

The candidate's matches: the jobs GetMattered found for their preferences and has not shown as decided, best fit first, the deck the candidate sees in the app. Reading it changes nothing. Free.

Authorization

DeveloperKey
headerAuthorizationBearer <gm_live_...>

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

Query Parameters

limit?integer

Matches per page, 1 to 50.

Range1 <= value <= 50
Default20
page?integer

The page, from 1 to 20.

Range1 <= value <= 20
Default1

Response Body

One page of matches.

application/json
  1. response

Successful API response

data*
meta?
success*true
Value intrue
Example Request
curl -X GET 'https://api.getmattered.com/api/v1/developer/jobs/matches'
Example Response
{
  "data": {
    "hasMore": true,
    "matches": [
      {
        "company": "string",
        "id": 1,
        "location": "string",
        "matchScore": 0,
        "postedDate": "string",
        "postingUrl": "string",
        "title": "string",
        "workArrangement": "onsite"
      }
    ],
    "page": 0,
    "preferencesMissing": true
  },
  "meta": {
    "duration": 0,
    "performance": {
      "dbQueries": 0,
      "totalDbTime": 0
    },
    "requestId": "string",
    "timestamp": "2019-08-24T14:15:22Z",
    "version": "string"
  },
  "success": true
}