Skip to main content
GET
/
v1
/
job-titles
Retrieve job title list
curl --request GET \
  --url https://api-staging.respondent.io/v1/job-titles \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-api-secret: <x-api-secret>'
{
  "page": 1,
  "pageSize": 50,
  "results": [
    {
      "id": "<string>",
      "name": "<string>"
    }
  ],
  "totalResults": 123
}

Headers

​
x-api-key
string
required
​
x-api-secret
string
required

Query Parameters

​
page
number
default:1
​
pageSize
number
default:50
​
includeCount
boolean
default:false
​
query
string

Character Limit: min 3 and max 100

​
seniority
enum<string>[]

Filter job titles by seniority levels. When provided, returns job titles that have at least one of the specified seniority levels.

Available options:
unpaid,
student,
training,
entrylevel,
senior,
manager,
director,
chiefofficer,
partner,
vicepresident

Response

200 - application/json
​
page
number
default:1
required
​
pageSize
number
default:50
required
​
results
object[]
required
​
totalResults
number

The total number of results possible, which is only provided in the response when includeCount is passed as true within a request.