Read job preferences
The candidate's job preferences: target titles, locations, remote, salary and the rest, in the shape GetMattered saves them. The defaults when none are saved. Free.
DeveloperKeyAuthorizationBearer <gm_live_...>A GetMattered developer API key, sent as Authorization: Bearer gm_live_....
The preferences.
application/json- response
Successful API response
data*meta?success*truetruecurl -X GET 'https://api.getmattered.com/api/v1/developer/preferences'{
"data": {
"benefits": null,
"companySize": [
"startup",
"medium"
],
"createdAt": "2026-09-01T12:00:00.000Z",
"educationLevel": "bachelor",
"excludeIndustries": null,
"experienceLevel": "senior",
"experienceLevels": [
"senior"
],
"id": 311,
"includeRemote": true,
"industries": [
"Software & SaaS",
"Financial Services"
],
"isActive": true,
"jobTypes": [
"full_time"
],
"locations": [
"San Francisco, United States"
],
"remoteGlobal": false,
"salaryCurrency": "usd",
"salaryMax": 190000,
"salaryMin": 150000,
"skills": [
"TypeScript",
"React",
"Node.js",
"PostgreSQL"
],
"targetRoles": [
"Senior Software Engineer",
"Full Stack Developer"
],
"updatedAt": "2026-09-20T08:30:00.000Z",
"visaSponsorship": null,
"workStyles": [
"remote",
"hybrid"
]
},
"success": true
}Upload a resume POST
Uploads a new resume for the candidate, the way the GetMattered upload does: the same file types and 10 MB limit, and it becomes the resume GetMattered applies with. GetMattered reads the file before it answers, so the answer carries the text it read. Spends the tokens it uses plus the request fee, recorded as `parse`. At most 10 uploads a minute per account.
Save job preferences PUT
Saves the candidate's job preferences the way GetMattered saves them: titles and places are matched to known ones, then the matches are rebuilt for the new search. Fields you omit stay as saved. At most 6 saves in 5 minutes per account, the app's limit. Free.