> ## 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.

> Retrieve all enumerated lookup values (age groups, education levels, genders, income brackets, and more). Use these values when configuring demographic targeting criteria on projects.

# Retrieve lookup values



## OpenAPI

````yaml get /v1/lookups
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/lookups:
    get:
      tags:
        - lookups
      summary: Retrieve lookup values
      description: >-
        Lookup lists of values for dropdowns; intended to be cached

        and not used in front ends directly.

        Using `?pick[]=country&contexts[]=project` will return a list of
        countries

        supported by when creating a project.


        `contexts` can only be used with the `country` lookup alone.


        _note:_

        - `jobTitles` is a very large list and throws an error in Prod,

        please use `/v1/job-titles` endpoint that is paginated

        - `industries`, `skills`, `topics` return a LOT of data and

        can be very slow to return


        _note:_

        - The following lookups' codes will change per environment as they are
        based on ids:

        [`industries`, `jobTitles`, `skills`, `topics`]

        - the rest will remain the same across environments
      operationId: LookupsController_findAll
      parameters:
        - name: x-api-key
          in: header
          required: true
          schema:
            type: string
        - name: x-api-secret
          in: header
          required: true
          schema:
            type: string
        - name: pick
          required: true
          in: query
          schema:
            type: array
            items:
              $ref: '#/components/schemas/LookupGroup'
        - name: contexts
          required: false
          in: query
          schema:
            type: array
            items:
              $ref: '#/components/schemas/Context'
        - name: lang
          required: false
          in: query
          schema:
            $ref: '#/components/schemas/Language'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupsMinimalDto'
components:
  schemas:
    LookupGroup:
      type: string
      enum:
        - marketType
        - researchMethodology
        - typeOfResearch
        - ageGroup
        - companySize
        - country
        - educationLevel
        - employmentStatus
        - ethnicity
        - gender
        - householdIncome
        - industries
        - jobFunction
        - jobTitles
        - keyQualifier
        - seniorityLevel
        - skills
        - topics
    Context:
      type: string
      enum:
        - project
        - profile
    Language:
      type: string
      default: en
      enum:
        - en
    LookupsMinimalDto:
      type: object
      properties:
        ageGroup:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        companySize:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        country:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        educationLevel:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        employmentStatus:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        ethnicity:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        gender:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        householdIncome:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        industries:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        jobTitles:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        skills:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        topics:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        seniorityLevel:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        jobFunction:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        income:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        programmingLanguage:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        browser:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        smartphoneOS:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        tabletOS:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        computerOS:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        relationshipStatus:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        language:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        livingSituation:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        pet:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        keyQualifier:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        screenerResponseStatus:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        typeOfResearch:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        marketType:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
        researchMethodology:
          type: array
          items:
            $ref: '#/components/schemas/LookupMinimalDto'
    LookupMinimalDto:
      type: object
      properties:
        code:
          type: string
        value:
          type: string
        weight:
          type: number
        disabled:
          type: boolean
      required:
        - code
        - value

````