Skip to Content
Candidate

Read job preferences

GET
/developer/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.

Authorization

DeveloperKey
headerAuthorizationBearer <gm_live_...>

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

Response Body

The preferences.

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/preferences'
Example Response
{
  "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
}