> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paraform.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Your saved role preferences

<Info>
  **Required scopes:** `roles:read`<br />
  **Rate limit:** `default` tier, 120 requests per minute per key
</Info>

The role preferences saved on your Paraform profile: the same values the in-app profile page shows, and the ones `listRecruiterRoles` applies when you pass `matchMyPreferences`.

An empty array means nothing is saved for that preference, so `matchMyPreferences` adds no filter for it; `minSalary` null means no salary preference is saved. `minSalary` is the saved annual salary preference as a whole number; no currency is stored with it. `matchMyPreferences` applies it to the role salary-band filter, so matched roles are ones whose salary band reaches it, not roles whose minimum meets it. `description` is the recruiter's own free text, null when none was written.

These are stated preferences, not inferred ones. Paraform separately derives specialties from a recruiter's placement history, and those are not returned here.

This endpoint is read-only. Preferences are edited in the Paraform app.

## Response

<ResponseField name="roleTypes" type="string[]" required />

<ResponseField name="locations" type="string[]" required />

<ResponseField name="industries" type="string[]" required />

<ResponseField name="workplaceTypes" type="string[]" required />

<ResponseField name="fundingRounds" type="string[]" required />

<ResponseField name="minSalary" type="number | null" required />

<ResponseField name="description" type="string | null" required />

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://external-api.paraform.com/api/external/v1/recruiter/preferences" \
    -H "Authorization: Bearer $PARAFORM_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "roleTypes": [
      "string"
    ],
    "locations": [
      "string"
    ],
    "industries": [
      "string"
    ],
    "workplaceTypes": [
      "string"
    ],
    "fundingRounds": [
      "string"
    ],
    "minSalary": 0,
    "description": "string"
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.