# Read job preferences (/docs/reference/preferences-get)

`GET https://api.getmattered.com/api/v1/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.

Authentication: `Authorization: Bearer gm_live_...` (see /authentication.md).

## Responses

### 200: The preferences.

```json
{
  "type": "object",
  "properties": {
    "data": {
      "allOf": [
        {
          "type": "object",
          "properties": {
            "benefits": {
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": "string"
              }
            },
            "companySize": {
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": "string"
              }
            },
            "createdAt": {
              "type": [
                "string",
                "null"
              ]
            },
            "educationLevel": {
              "type": [
                "string",
                "null"
              ]
            },
            "excludeIndustries": {
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": "string"
              }
            },
            "experienceLevel": {
              "type": [
                "string",
                "null"
              ]
            },
            "experienceLevels": {
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": "string"
              }
            },
            "id": {
              "type": "integer"
            },
            "includeRemote": {
              "type": "boolean"
            },
            "industries": {
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": "string"
              }
            },
            "isActive": {
              "type": "boolean"
            },
            "jobTypes": {
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": "string"
              }
            },
            "locations": {
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": "string"
              }
            },
            "remoteGlobal": {
              "type": "boolean"
            },
            "salaryCurrency": {
              "type": "string",
              "enum": [
                "usd",
                "eur",
                "gbp",
                "cad",
                "aud",
                "inr"
              ],
              "description": "Currency for salary values",
              "example": "usd"
            },
            "salaryMax": {
              "type": [
                "number",
                "null"
              ]
            },
            "salaryMin": {
              "type": [
                "number",
                "null"
              ]
            },
            "skills": {
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": "string"
              }
            },
            "targetRoles": {
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": "string"
              }
            },
            "updatedAt": {
              "type": [
                "string",
                "null"
              ]
            },
            "visaSponsorship": {
              "type": [
                "string",
                "null"
              ]
            },
            "workStyles": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "onsite",
                  "hybrid",
                  "remote"
                ],
                "description": "User's preferred work style, physical mode only, no geo scoping",
                "example": "remote"
              }
            }
          },
          "required": [
            "benefits",
            "companySize",
            "createdAt",
            "educationLevel",
            "excludeIndustries",
            "experienceLevel",
            "experienceLevels",
            "id",
            "includeRemote",
            "industries",
            "isActive",
            "jobTypes",
            "locations",
            "remoteGlobal",
            "salaryCurrency",
            "salaryMax",
            "salaryMin",
            "skills",
            "targetRoles",
            "updatedAt",
            "visaSponsorship",
            "workStyles"
          ]
        },
        {
          "type": "object",
          "properties": {
            "prefsChanged": {
              "type": "boolean",
              "description": "PUT only. True when this save changed at least one job_match_preference column (always true when it created the row). False means nothing moved. Absent on GET.",
              "example": true
            }
          }
        }
      ]
    },
    "meta": {
      "type": "object",
      "properties": {
        "duration": {
          "type": "number",
          "minimum": 0,
          "description": "Request duration in milliseconds",
          "example": 150
        },
        "performance": {
          "type": "object",
          "properties": {
            "dbQueries": {
              "type": "integer",
              "minimum": 0
            },
            "totalDbTime": {
              "type": "number",
              "minimum": 0
            }
          },
          "description": "Performance metrics (preview/local only)"
        },
        "requestId": {
          "type": "string",
          "description": "Unique request identifier",
          "example": "req_abc123"
        },
        "timestamp": {
          "type": "string",
          "format": "date-time",
          "description": "ISO 8601 timestamp",
          "example": "2026-11-17T12:00:00.000Z"
        },
        "version": {
          "type": "string",
          "description": "API version",
          "example": "v1"
        }
      }
    },
    "success": {
      "type": "boolean",
      "enum": [
        true
      ]
    }
  },
  "required": [
    "data",
    "success"
  ],
  "additionalProperties": false,
  "description": "Successful API response",
  "example": {
    "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
  }
}
```

### 400: Bad Request

### 401: Unauthorized

### 404: Not Found

### 429: Too Many Requests

### 500: Internal Server Error

### 503: Service Unavailable

Error responses use the envelope in /errors.md.