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

> Search and retrieve job titles used for B2B project targeting. Supports pagination — use `pageSize=50000` to fetch the full list. Use the returned IDs when setting `jobTitleIds` on a project. **Note:** IDs differ between staging and production.

# Retrieve job title list



## OpenAPI

````yaml get /v1/job-titles
openapi: 3.0.0
info:
  title: Partner API
  description: Public API for partner integrations
  version: '1.0'
  contact: {}
servers:
  - url: https://api-staging.respondent.io
security: []
tags: []
paths:
  /v1/job-titles:
    get:
      tags:
        - job-titles
      summary: Retrieve job title list
      description: |-
        Find all job titles paginated

        To get all job titles, run `/v1/job-titles?pageSize=50000&page=1`
      operationId: JobTitlesController_search
      parameters:
        - name: x-api-key
          in: header
          required: true
          schema:
            type: string
        - name: x-api-secret
          in: header
          required: true
          schema:
            type: string
        - name: page
          required: false
          in: query
          schema:
            type: number
            default: 1
        - name: pageSize
          required: false
          in: query
          schema:
            type: number
            default: 50
        - name: includeCount
          required: false
          in: query
          schema:
            type: boolean
            default: false
        - name: query
          required: false
          in: query
          description: 'Character Limit: min 3 and max 100'
          schema:
            type: string
        - name: seniority
          required: false
          in: query
          description: >-
            Filter job titles by seniority levels.

            When provided, returns job titles that have at least one of the
            specified seniority levels.
          schema:
            type: array
            items:
              $ref: '#/components/schemas/SeniorityLevel'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SimpleJobTitlesPaginatedDto'
components:
  schemas:
    SeniorityLevel:
      type: string
      enum:
        - unpaid
        - student
        - training
        - entrylevel
        - senior
        - manager
        - director
        - chiefofficer
        - partner
        - vicepresident
    SimpleJobTitlesPaginatedDto:
      type: object
      properties:
        totalResults:
          type: number
          description: >-
            The total number of results possible, which is only provided in the
            response when `includeCount` is passed as `true` within a request.
        page:
          type: number
          default: 1
        pageSize:
          type: number
          default: 50
        results:
          type: array
          items:
            $ref: '#/components/schemas/SimpleJobTitle'
      required:
        - page
        - pageSize
        - results
    SimpleJobTitle:
      type: object
      properties:
        id:
          type: string
          format: ObjectId
        name:
          type: string
      required:
        - id
        - name

````