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

# List jobs

> Returns a list of jobs. Uses cursor pagination.



## OpenAPI

````yaml /openapi-private.json get /vacancies
openapi: 3.1.0
info:
  title: Spott API Reference
  version: '0.1'
servers:
  - url: https://api.gospott.com
security: []
tags: []
paths:
  /vacancies:
    get:
      tags:
        - Jobs
      summary: List jobs
      description: Returns a list of jobs. Uses cursor pagination.
      operationId: getVacancies
      parameters:
        - name: limit
          required: false
          in: query
          description: 'Number of jobs to return per page (min: 1, max: 50, default: 25).'
          schema:
            minimum: 1
            maximum: 50
            default: 25
            example: 25
            type: integer
        - name: cursor
          required: false
          in: query
          description: >-
            Base64-encoded cursor for pagination. Use the nextCursor value from
            a previous response to fetch the next page. Omit for the first page.
          schema:
            example: >-
              eyJtb2RpZmllZEF0IjoiMjAyNC0xMS0wNlQxMDozMDowMC4wMDBaIiwiaWQiOiJ2YWNhbmN5LTEyMyJ9
            type: string
        - name: modifiedSince
          required: false
          in: query
          description: >-
            Filter jobs by sync watermark on or after this date. Useful for
            incremental synchronization. Defaults to beginning of time if not
            provided.
          schema:
            $ref: '#/components/schemas/DateISO'
            default: '1970-01-01T00:00:00.000Z'
            example: '2024-11-01T00:00:00.000Z'
        - name: modifiedUntil
          required: false
          in: query
          description: >-
            Filter jobs by sync watermark on or before this date. Useful for
            bounded synchronization snapshots. If omitted, no upper bound is
            applied.
          schema:
            $ref: '#/components/schemas/DateISO'
            example: '2024-11-30T23:59:59.999Z'
        - name: companyIds
          required: false
          in: query
          description: Filter jobs by company IDs.
          schema:
            example:
              - company-123
              - company-456
            type: array
            items:
              type: string
        - name: candidateEmailAddresses
          required: false
          in: query
          description: >-
            Filter jobs by candidate email addresses. Returns jobs that have at
            least one application from a candidate with a matching email.
          schema:
            minItems: 1
            maxItems: 25
            example:
              - candidate@example.com
            type: array
            items:
              type: string
              format: email
              pattern: >-
                ^(([^<>()\[\]\\.,;:\s@"]+(\.[^<>()\[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$
        - name: include
          required: false
          in: query
          description: >-
            Optional related data to include in the response. Available options:
            jobBoards.
          schema:
            uniqueItems: true
            example:
              - jobBoards
            type: array
            items:
              type: string
              enum:
                - jobBoards
      responses:
        '200':
          description: >-
            Successfully retrieved jobs. Returns items array with pagination
            info containing cursor for the next page.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetVacanciesResponseDto'
        '400':
          description: >-
            Bad request - invalid query parameters (e.g., limit out of range,
            invalid date format)
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ExceptionBaseDto'
                  - type: object
                    properties:
                      statusCode:
                        type: number
                        example: 400
                      message:
                        type: string
                        example: Limit must be between 1 and 50
                      error:
                        type: string
                        example: Bad Request
        '401':
          description: Unauthorized - invalid or missing authentication
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionBaseDto'
        '500':
          description: Error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExceptionBaseDto'
      security:
        - x-api-key: []
components:
  schemas:
    DateISO:
      id: DateISO
      format: date-time
      anyOf:
        - type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
        - type: string
          format: date
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
    GetVacanciesResponseDto:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/VacancyCursorBaseDto'
        pageInfo:
          $ref: '#/components/schemas/CursorPageInfoDto'
      required:
        - items
        - pageInfo
      id: PrivateGetVacanciesResponseDto
    ExceptionBaseDto:
      type: object
      properties:
        status:
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        message:
          type: string
        requestId:
          type: string
      required:
        - status
        - message
        - requestId
      id: ExceptionBaseDto
    VacancyCursorBaseDto:
      type: object
      properties:
        id:
          type: string
          minLength: 1
        restricted:
          type: boolean
        client:
          type: object
          properties:
            viewType:
              type: string
              enum:
                - vacancyClient
            client:
              type: object
              properties:
                id:
                  type: string
                  minLength: 1
                name:
                  type: string
                description:
                  anyOf:
                    - type: string
                    - type: 'null'
                industry:
                  anyOf:
                    - type: string
                      enum:
                        - Accessible Architecture and Design
                        - Accessible Hardware Manufacturing
                        - Accommodation and Food Services
                        - Accounting
                        - Administration of Justice
                        - Administrative and Support Services
                        - Advertising Services
                        - Agricultural Chemical Manufacturing
                        - >-
                          Agriculture, Construction, Mining Machinery
                          Manufacturing
                        - Air, Water and Waste Program Management
                        - Aviation & Aerospace
                        - Airlines and Aviation
                        - Abrasives and Nonmetallic Minerals Manufacturing
                        - Alternative Dispute Resolution
                        - Alternative Fuel Vehicle Manufacturing
                        - Alternative Medicine
                        - Ambulance Services
                        - Amusement Parks and Arcades
                        - Animal Feed Manufacturing
                        - Animation
                        - Animation and Post-production
                        - Apparel Manufacturing
                        - Apparel & Fashion
                        - Appliances, Electrical, and Electronics Manufacturing
                        - Architecture and Planning
                        - Architectural and Structural Metal Manufacturing
                        - Armed Forces
                        - Artificial Rubber and Synthetic Fiber Manufacturing
                        - Artists and Writers
                        - Arts & Crafts
                        - Audio and Video Equipment Manufacturing
                        - Automation Machinery Manufacturing
                        - Automotive
                        - Aviation and Aerospace Component Manufacturing
                        - Baked Goods Manufacturing
                        - Banking
                        - Bars, Taverns and Nightclubs
                        - Bed and Breakfasts, Hostels, Homestays
                        - Beverage Manufacturing
                        - Biomass Electric Power Generation
                        - Biotechnology
                        - Biotechnology Research
                        - Blockchain Services
                        - Blogs
                        - Boilers, Tanks, and Shipping Container Manufacturing
                        - Book and Periodical Publishing
                        - Book Publishing
                        - Breweries
                        - Broadcast Media Production and Distribution
                        - Building Construction
                        - Building Equipment Contractors
                        - Building Finishing Contractors
                        - Building Materials
                        - Building Structure and Exterior Contractors
                        - Business Consulting and Services
                        - Business Content
                        - Business Intelligence Platforms
                        - Business Supplies & Equipment
                        - Cable and Satellite Programming
                        - Capital Markets
                        - Caterers
                        - Chemical Manufacturing
                        - Chemical Raw Materials Manufacturing
                        - Child Day Care Services
                        - Chiropractors
                        - Circuses and Magic Shows
                        - Civic and Social Organizations
                        - Civil Engineering
                        - Claims Adjusting, Actuarial Services
                        - Clay and Refractory Products Manufacturing
                        - Climate Data and Analytics
                        - Climate Technology Product Manufacturing
                        - Coal Mining
                        - Collection Agencies
                        - Commercial and Industrial Equipment Rental
                        - Commercial and Industrial Machinery Maintenance
                        - >-
                          Commercial and Service Industry Machinery
                          Manufacturing
                        - Commercial Real Estate
                        - Communications Equipment Manufacturing
                        - Community Development and Urban Planning
                        - Community Services
                        - Computer and Network Security
                        - Computer Games
                        - Computer Hardware
                        - Computer Hardware Manufacturing
                        - Computer Networking
                        - Computer Networking Products
                        - Computers and Electronics Manufacturing
                        - Conservation Programs
                        - Construction
                        - Construction Hardware Manufacturing
                        - Consumer Electronics
                        - Consumer Goods
                        - Consumer Goods Rental
                        - Consumer Services
                        - Correctional Institutions
                        - Cosmetics
                        - Cosmetology and Barber Schools
                        - Courts of Law
                        - Credit Intermediation
                        - Cutlery and Handtool Manufacturing
                        - Dairy
                        - Dairy Product Manufacturing
                        - Dance Companies
                        - Data Infrastructure and Analytics
                        - Data Security Software Products
                        - Defense and Space Manufacturing
                        - Defense & Space
                        - Dentists
                        - Design
                        - Design Services
                        - Desktop Computing Software Products
                        - Digital Accessibility Services
                        - Distilleries
                        - E-learning
                        - E-Learning Providers
                        - Economic Programs
                        - Education
                        - Education Administration Programs
                        - Education Management
                        - Electric Lighting Equipment Manufacturing
                        - Electric Power Generation
                        - Electric Power Transmission, Control, and Distribution
                        - Electrical Equipment Manufacturing
                        - Electronic and Precision Equipment Maintenance
                        - Embedded Software Products
                        - Emergency and Relief Services
                        - Energy Technology
                        - Engineering Services
                        - Engines and Power Transmission Equipment Manufacturing
                        - Entertainment
                        - Entertainment Providers
                        - Environmental Quality Programs
                        - Environmental Services
                        - Equipment Rental Services
                        - Events Services
                        - Executive Offices
                        - Executive Search Services
                        - Fabricated Metal Products
                        - Facilities Services
                        - Family Planning Centers
                        - Farming
                        - Farming, Ranching, Forestry
                        - Fashion Accessories Manufacturing
                        - Financial Services
                        - Fine Art
                        - Fine Arts Schools
                        - Fire Protection
                        - Fisheries
                        - Flight Training
                        - Food and Beverage Manufacturing
                        - Food and Beverage Retail
                        - Food and Beverage Services
                        - Food & Beverages
                        - Food Production
                        - Footwear and Leather Goods Repair
                        - Footwear Manufacturing
                        - Forestry and Logging
                        - Fossil Fuel Electric Power Generation
                        - Freight and Package Transportation
                        - Fruit and Vegetable Preserves Manufacturing
                        - Fuel Cell Manufacturing
                        - Fundraising
                        - Funds and Trusts
                        - Furniture
                        - Furniture and Home Furnishings Manufacturing
                        - Gambling Facilities and Casinos
                        - Geothermal Electric Power Generation
                        - Glass Product Manufacturing
                        - Glass, Ceramics and Concrete Manufacturing
                        - Golf Courses and Country Clubs
                        - Government Administration
                        - Government Relations
                        - Government Relations Services
                        - Graphic Design
                        - Ground Passenger Transportation
                        - Health and Human Services
                        - Health, Wellness & Fitness
                        - Higher Education
                        - Highway, Street, and Bridge Construction
                        - Historical Sites
                        - Holding Companies
                        - Home Health Care Services
                        - Horticulture
                        - Hospitality
                        - Hospitals
                        - Hospitals and Health Care
                        - Hotels and Motels
                        - Household Appliance Manufacturing
                        - Household and Institutional Furniture Manufacturing
                        - Household Services
                        - Housing and Community Development
                        - Housing Programs
                        - Human Resources
                        - Human Resources Services
                        - HVAC and Refrigeration Equipment Manufacturing
                        - Hydroelectric Power Generation
                        - Import & Export
                        - Individual and Family Services
                        - Industrial Automation
                        - Industrial Machinery Manufacturing
                        - Industry Associations
                        - Information Services
                        - Information Technology & Services
                        - Insurance
                        - Insurance Agencies and Brokerages
                        - Insurance and Employee Benefit Funds
                        - Insurance Carriers
                        - Interior Design
                        - International Affairs
                        - International Trade and Development
                        - Internet Marketplace Platforms
                        - Internet News
                        - Internet Publishing
                        - Interurban and Rural Bus Services
                        - Investment Advice
                        - Investment Banking
                        - Investment Management
                        - IT Services and IT Consulting
                        - IT System Custom Software Development
                        - IT System Data Services
                        - IT System Design Services
                        - IT System Installation and Disposal
                        - IT System Operations and Maintenance
                        - IT System Testing and Evaluation
                        - IT System Training and Support
                        - Janitorial Services
                        - Landscaping Services
                        - Language Schools
                        - Laundry and Drycleaning Services
                        - Law Enforcement
                        - Law Practice
                        - Leasing Non-residential Real Estate
                        - Leasing Residential Real Estate
                        - Leather Product Manufacturing
                        - Legal Services
                        - Legislative Offices
                        - Leisure, Travel & Tourism
                        - Libraries
                        - Lime and Gypsum Products Manufacturing
                        - Loan Brokers
                        - Luxury Goods & Jewelry
                        - Machinery Manufacturing
                        - Magnetic and Optical Media Manufacturing
                        - Manufacturing
                        - Maritime
                        - Maritime Transportation
                        - Marketing Services
                        - Market Research
                        - Mattress and Blinds Manufacturing
                        - Measuring and Control Instrument Manufacturing
                        - Meat Products Manufacturing
                        - Mechanical Or Industrial Engineering
                        - Media and Telecommunications
                        - Media Production
                        - Medical and Diagnostic Laboratories
                        - Medical Device
                        - Medical Equipment Manufacturing
                        - Medical Practices
                        - Mental Health Care
                        - Metal Ore Mining
                        - Metal Treatments
                        - Metal Valve, Ball, and Roller Manufacturing
                        - Metalworking Machinery Manufacturing
                        - Military and International Affairs
                        - Mining
                        - Mobile Computing Software Products
                        - Mobile Food Services
                        - Mobile Gaming Apps
                        - Motor Vehicle Manufacturing
                        - Motor Vehicle Parts Manufacturing
                        - Movies and Sound Recording
                        - Movies, Videos, and Sound
                        - Museums
                        - Museums, Historical Sites, and Zoos
                        - Music
                        - Musicians
                        - Nanotechnology Research
                        - Natural Gas Distribution
                        - Natural Gas Extraction
                        - Newspaper Publishing
                        - Nonmetallic Mineral Mining
                        - Non-profit Organization Management
                        - Non-profit Organizations
                        - Nonresidential Building Construction
                        - Nuclear Electric Power Generation
                        - Nursing Homes and Residential Care Facilities
                        - Office Administration
                        - Office Furniture and Fixtures Manufacturing
                        - Oil and Coal Product Manufacturing
                        - Oil and Gas
                        - Oil Extraction
                        - Oil, Gas, and Mining
                        - Online and Mail Order Retail
                        - Online Audio and Video Media
                        - Online Media
                        - Operations Consulting
                        - Optometrists
                        - Outpatient Care Centers
                        - Outsourcing and Offshoring Consulting
                        - Outsourcing/Offshoring
                        - Packaging and Containers Manufacturing
                        - Packaging & Containers
                        - Paint, Coating, and Adhesive Manufacturing
                        - Paper and Forest Product Manufacturing
                        - Paper & Forest Products
                        - Pension Funds
                        - Performing Arts
                        - Performing Arts and Spectator Sports
                        - Periodical Publishing
                        - Personal and Laundry Services
                        - Personal Care Product Manufacturing
                        - Personal Care Services
                        - Pet Services
                        - Pharmaceutical Manufacturing
                        - Philanthropic Fundraising Services
                        - Philanthropy
                        - Photography
                        - Physical, Occupational and Speech Therapists
                        - Physicians
                        - Pipeline Transportation
                        - Plastics and Rubber Product Manufacturing
                        - Plastics Manufacturing
                        - Political Organizations
                        - Postal Services
                        - Primary and Secondary Education
                        - Primary Metal Manufacturing
                        - Printing Services
                        - Professional Organizations
                        - Professional Services
                        - Professional Training and Coaching
                        - Program Development
                        - Public Assistance Programs
                        - Public Health
                        - Public Policy
                        - Public Policy Offices
                        - Public Relations and Communications Services
                        - Public Safety
                        - Racetracks
                        - Radio and Television Broadcasting
                        - Rail Transportation
                        - Railroad Equipment Manufacturing
                        - Ranching
                        - Ranching and Fisheries
                        - Real Estate
                        - Real Estate Agents and Brokers
                        - Real Estate and Equipment Rental Services
                        - Recreational Facilities
                        - Regenerative Design
                        - Religious Institutions
                        - Renewable Energy Equipment Manufacturing
                        - Renewable Energy Power Generation
                        - Renewable Energy Semiconductor Manufacturing
                        - Renewables & Environment
                        - Repair and Maintenance
                        - Research
                        - Research Services
                        - Residential Building Construction
                        - Restaurants
                        - Retail
                        - Retail Apparel and Fashion
                        - >-
                          Retail Appliances, Electrical, and Electronic
                          Equipment
                        - Retail Art Dealers
                        - Retail Art Supplies
                        - Retail Books and Printed News
                        - Retail Building Materials and Garden Equipment
                        - Retail Florists
                        - Retail Furniture and Home Furnishings
                        - Retail Gasoline
                        - Retail Groceries
                        - Retail Health and Personal Care Products
                        - Retail Luxury Goods and Jewelry
                        - Retail Motor Vehicles
                        - Retail Musical Instruments
                        - Retail Office Equipment
                        - Retail Office Supplies and Gifts
                        - Retail Pharmacies
                        - Retail Recyclable Materials & Used Merchandise
                        - Reupholstery and Furniture Repair
                        - Robotics Engineering
                        - Robot Manufacturing
                        - Rubber Products Manufacturing
                        - Satellite Telecommunications
                        - Savings Institutions
                        - School and Employee Bus Services
                        - Seafood Product Manufacturing
                        - Secretarial Schools
                        - Securities and Commodity Exchanges
                        - Security and Investigations
                        - Security Guards and Patrol Services
                        - Security Systems Services
                        - Semiconductor Manufacturing
                        - Semiconductors
                        - Services for Renewable Energy
                        - Services for the Elderly and Disabled
                        - Sheet Music Publishing
                        - Shipbuilding
                        - Shuttles and Special Needs Transportation Services
                        - Sightseeing Transportation
                        - Skiing Facilities
                        - Smart Meter Manufacturing
                        - Soap and Cleaning Product Manufacturing
                        - Social Networking Platforms
                        - Software Development
                        - Solar Electric Power Generation
                        - Sound Recording
                        - Space Research and Technology
                        - Specialty Trade Contractors
                        - Spectator Sports
                        - Sporting Goods
                        - Sporting Goods Manufacturing
                        - Sports and Recreation Instruction
                        - Sports Teams and Clubs
                        - Spring and Wire Product Manufacturing
                        - Staffing and Recruiting
                        - Steam and Air-Conditioning Supply
                        - Strategic Management Services
                        - Subdivision of Land
                        - Sugar and Confectionery Product Manufacturing
                        - Surveying and Mapping Services
                        - Taxi and Limousine Services
                        - Technical and Vocational Training
                        - Technology, Information and Internet
                        - Technology, Information and Media
                        - Telecommunications
                        - Telecommunications Carriers
                        - Telephone Call Centers
                        - Temporary Help Services
                        - Textile Manufacturing
                        - Theater Companies
                        - Think Tanks
                        - Tobacco
                        - Tobacco Manufacturing
                        - Translation and Localization
                        - Transportation Equipment Manufacturing
                        - Transportation, Logistics, Supply Chain and Storage
                        - Transportation Programs
                        - Transportation/Trucking/Railroad
                        - Travel Arrangements
                        - Truck Transportation
                        - Trusts and Estates
                        - Turned Products and Fastener Manufacturing
                        - Urban Transit Services
                        - Utilities
                        - Utilities Administration
                        - Utility System Construction
                        - Vehicle Repair and Maintenance
                        - Venture Capital and Private Equity Principals
                        - Veterinary
                        - Veterinary Services
                        - Vocational Rehabilitation Services
                        - Warehousing
                        - Warehousing and Storage
                        - Waste Collection
                        - Waste Treatment and Disposal
                        - Water Supply and Irrigation Systems
                        - Water, Waste, Steam, and Air Conditioning Services
                        - Wellness and Fitness Services
                        - Wholesale
                        - Wholesale Alcoholic Beverages
                        - Wholesale Apparel and Sewing Supplies
                        - Wholesale Appliances, Electrical, and Electronics
                        - Wholesale Building Materials
                        - Wholesale Chemical and Allied Products
                        - Wholesale Computer Equipment
                        - Wholesale Drugs and Sundries
                        - Wholesale Food and Beverage
                        - Wholesale Footwear
                        - Wholesale Furniture and Home Furnishings
                        - Wholesale Hardware, Plumbing, Heating Equipment
                        - Wholesale Import and Export
                        - Wholesale Luxury Goods and Jewelry
                        - Wholesale Machinery
                        - Wholesale Metals and Minerals
                        - Wholesale Motor Vehicles and Parts
                        - Wholesale Paper Products
                        - Wholesale Petroleum and Petroleum Products
                        - Wholesale Photography Equipment and Supplies
                        - Wholesale Raw Farm Products
                        - Wholesale Recyclable Materials
                        - Wind Electric Power Generation
                        - Wineries
                        - Wine & Spirits
                        - Wireless Services
                        - Women's Handbag Manufacturing
                        - Wood Product Manufacturing
                        - Writing and Editing
                        - Zoos and Botanical Gardens
                    - type: 'null'
                size:
                  anyOf:
                    - type: string
                      enum:
                        - 1 employee
                        - 2-10 employees
                        - 11-50 employees
                        - 51-200 employees
                        - 201-500 employees
                        - 501-1,000 employees
                        - 1,001-5,000 employees
                        - 5,001-10,000 employees
                        - 10,001+ employees
                    - type: 'null'
                domain:
                  anyOf:
                    - type: string
                    - type: 'null'
                logoUrl:
                  anyOf:
                    - type: string
                    - type: 'null'
              required:
                - id
                - name
                - description
                - industry
                - size
                - domain
                - logoUrl
          required:
            - viewType
            - client
        name:
          type: object
          properties:
            viewType:
              type: string
              enum:
                - vacancyName
            name:
              type: string
          required:
            - viewType
            - name
        description:
          type: object
          properties:
            viewType:
              type: string
              enum:
                - vacancyDescription
            description:
              anyOf:
                - type: string
                - type: 'null'
          required:
            - viewType
            - description
        stage:
          type: object
          properties:
            viewType:
              type: string
              enum:
                - vacancyStage
            stage:
              type: object
              properties:
                id:
                  type: string
                  minLength: 1
                order:
                  type: number
                name:
                  type: string
                colorHex:
                  type: string
                isOpen:
                  type: boolean
              required:
                - id
                - order
                - name
                - colorHex
                - isOpen
          required:
            - viewType
            - stage
        createdAt:
          type: object
          properties:
            viewType:
              type: string
              enum:
                - vacancyCreatedAt
            createdAt:
              $ref: '#/components/schemas/DateISO'
          required:
            - viewType
            - createdAt
        startAt:
          type: object
          properties:
            viewType:
              type: string
              enum:
                - vacancyStartAt
            startAt:
              anyOf:
                - $ref: '#/components/schemas/DateISO'
                - type: 'null'
          required:
            - viewType
            - startAt
        endAt:
          type: object
          properties:
            viewType:
              type: string
              enum:
                - vacancyEndAt
            endAt:
              anyOf:
                - $ref: '#/components/schemas/DateISO'
                - type: 'null'
          required:
            - viewType
            - endAt
        salaryRange:
          type: object
          properties:
            viewType:
              type: string
              enum:
                - vacancySalaryRange
            salaryRange:
              anyOf:
                - type: object
                  properties:
                    min:
                      anyOf:
                        - type: number
                        - type: 'null'
                    max:
                      anyOf:
                        - type: number
                        - type: 'null'
                    currency:
                      $ref: '#/components/schemas/DmCurrency'
                  required:
                    - min
                    - max
                    - currency
                - type: 'null'
          required:
            - viewType
            - salaryRange
        location:
          type: object
          properties:
            viewType:
              type: string
              enum:
                - vacancyLocation
            location:
              anyOf:
                - $ref: '#/components/schemas/LocationDto'
                - type: 'null'
              deprecated: true
              description: >-
                Deprecated: use `locations` instead. The primary (first)
                location of the job, or null when none.
            locations:
              type: array
              items:
                $ref: '#/components/schemas/VacancyLocationDto'
          required:
            - viewType
            - location
            - locations
        languages:
          type: object
          properties:
            viewType:
              type: string
              enum:
                - vacancyLanguages
            languages:
              type: array
              items:
                type: object
                properties:
                  language:
                    $ref: '#/components/schemas/DmLanguageEnum'
                  fluency:
                    anyOf:
                      - $ref: '#/components/schemas/DmFluencyEnum'
                      - type: 'null'
                required:
                  - language
                  - fluency
          required:
            - viewType
            - languages
        team:
          type: object
          properties:
            viewType:
              type: string
              enum:
                - vacancyTeam
            team:
              type: array
              items:
                type: object
                properties:
                  userId:
                    type: string
                    minLength: 1
                  name:
                    type: string
                  email:
                    type: string
                    format: email
                    pattern: >-
                      ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
                  avatarUrl:
                    anyOf:
                      - type: string
                      - type: 'null'
                  deactivatedAt:
                    anyOf:
                      - $ref: '#/components/schemas/DateISO'
                      - type: 'null'
                required:
                  - userId
                  - name
                  - email
                  - avatarUrl
                  - deactivatedAt
          required:
            - viewType
            - team
        employmentType:
          type: object
          properties:
            viewType:
              type: string
              enum:
                - vacancyEmploymentType
            employmentType:
              anyOf:
                - type: string
                  enum:
                    - fullTime
                    - partTime
                    - temporary
                    - internship
                    - permanent
                    - fixedTermContract
                    - interimOrTemporary
                    - contract
                - type: 'null'
          required:
            - viewType
            - employmentType
        locationType:
          type: object
          properties:
            viewType:
              type: string
              enum:
                - vacancyLocationType
            locationType:
              anyOf:
                - type: string
                  enum:
                    - remote
                    - hybrid
                    - onsite
                - type: 'null'
          required:
            - viewType
            - locationType
        clientTeam:
          type: object
          properties:
            viewType:
              type: string
              enum:
                - vacancyClientTeam
            clientTeam:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    minLength: 1
                  firstName:
                    type: string
                  lastName:
                    type: string
                  middleName:
                    anyOf:
                      - type: string
                      - type: 'null'
                  secondLastName:
                    anyOf:
                      - type: string
                      - type: 'null'
                  avatarUrl:
                    anyOf:
                      - type: string
                      - type: 'null'
                  candidateId:
                    type: string
                    minLength: 1
                  companyId:
                    type: string
                    minLength: 1
                  companyName:
                    type: string
                  companyLogoUrl:
                    anyOf:
                      - type: string
                      - type: 'null'
                  jobTitle:
                    anyOf:
                      - type: string
                      - type: 'null'
                  department:
                    anyOf:
                      - type: string
                      - type: 'null'
                  emails:
                    type: array
                    items:
                      $ref: '#/components/schemas/ContactEmailDto'
                  phoneNumbers:
                    type: array
                    items:
                      $ref: '#/components/schemas/ContactPhoneDto'
                required:
                  - id
                  - firstName
                  - lastName
                  - middleName
                  - secondLastName
                  - avatarUrl
                  - candidateId
                  - companyId
                  - companyName
                  - companyLogoUrl
                  - jobTitle
                  - department
                  - emails
                  - phoneNumbers
          required:
            - viewType
            - clientTeam
        scorecard:
          type: object
          properties:
            viewType:
              type: string
              enum:
                - vacancyScorecard
            scorecards:
              type: array
              items:
                type: object
                properties:
                  groupName:
                    type: string
                  attributes:
                    type: array
                    items:
                      type: object
                      properties:
                        attribute:
                          type: string
                      required:
                        - attribute
                required:
                  - groupName
                  - attributes
          required:
            - viewType
            - scorecards
        nextTaskDue:
          type: object
          properties:
            viewType:
              type: string
              enum:
                - vacancyNextTaskDue
            nextTaskDue:
              anyOf:
                - $ref: '#/components/schemas/NextTaskDueDto'
                - type: 'null'
          required:
            - viewType
            - nextTaskDue
        jobBoards:
          description: >-
            Job board postings associated with this job. Only included when
            "jobBoards" is specified in the include parameter.
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                minLength: 1
            required:
              - id
      required:
        - id
        - restricted
        - client
        - name
        - description
        - stage
        - createdAt
        - startAt
        - endAt
        - salaryRange
        - location
        - languages
        - team
        - employmentType
        - locationType
        - clientTeam
        - scorecard
        - nextTaskDue
      id: PrivateVacancyCursorBaseDto
    CursorPageInfoDto:
      type: object
      properties:
        nextCursor:
          anyOf:
            - type: string
            - type: 'null'
          deprecated: true
          description: 'Deprecated: use pagination.cursor instead.'
        hasNextPage:
          type: boolean
          deprecated: true
          description: 'Deprecated: use the presence of pagination.cursor instead.'
      required:
        - nextCursor
        - hasNextPage
      id: CursorPageInfoDto
    DmCurrency:
      type: string
      enum:
        - AED
        - AFN
        - ALL
        - AMD
        - ANG
        - AOA
        - ARS
        - AUD
        - AWG
        - AZN
        - BAM
        - BBD
        - BDT
        - BGN
        - BHD
        - BIF
        - BMD
        - BND
        - BOB
        - BRL
        - BSD
        - BTC
        - BTN
        - BWP
        - BYN
        - BZD
        - CAD
        - CDF
        - CHF
        - CLF
        - CLP
        - CNH
        - CNY
        - COP
        - CRC
        - CUC
        - CUP
        - CVE
        - CZK
        - DJF
        - DKK
        - DOP
        - DZD
        - EGP
        - ERN
        - ETB
        - EUR
        - FJD
        - FKP
        - GBP
        - GEL
        - GGP
        - GHS
        - GIP
        - GMD
        - GNF
        - GTQ
        - GYD
        - HKD
        - HNL
        - HRK
        - HTG
        - HUF
        - IDR
        - ILS
        - IMP
        - INR
        - IQD
        - IRR
        - ISK
        - JEP
        - JMD
        - JOD
        - JPY
        - KES
        - KGS
        - KHR
        - KMF
        - KPW
        - KRW
        - KWD
        - KYD
        - KZT
        - LAK
        - LBP
        - LKR
        - LRD
        - LSL
        - LYD
        - MAD
        - MDL
        - MGA
        - MKD
        - MMK
        - MNT
        - MOP
        - MRU
        - MUR
        - MVR
        - MWK
        - MXN
        - MYR
        - MZN
        - NAD
        - NGN
        - NIO
        - NOK
        - NPR
        - NZD
        - OMR
        - PAB
        - PEN
        - PGK
        - PHP
        - PKR
        - PLN
        - PYG
        - QAR
        - RON
        - RSD
        - RUB
        - RWF
        - SAR
        - SBD
        - SCR
        - SDG
        - SEK
        - SGD
        - SHP
        - SLE
        - SLL
        - SOS
        - SRD
        - SSP
        - STD
        - STN
        - SVC
        - SYP
        - SZL
        - THB
        - TJS
        - TMT
        - TND
        - TOP
        - TRY
        - TTD
        - TWD
        - TZS
        - UAH
        - UGX
        - USD
        - UYU
        - UZS
        - VEF
        - VES
        - VND
        - VUV
        - WST
        - XAF
        - XAG
        - XAU
        - XCD
        - XCG
        - XDR
        - XOF
        - XPD
        - XPF
        - XPT
        - YER
        - ZAR
        - ZMW
        - ZWG
        - ZWL
      id: DmCurrency
    LocationDto:
      type: object
      properties:
        street1:
          anyOf:
            - type: string
            - type: 'null'
        street2:
          anyOf:
            - type: string
            - type: 'null'
        postalCode:
          anyOf:
            - type: string
            - type: 'null'
        city:
          anyOf:
            - type: string
            - type: 'null'
        region:
          anyOf:
            - type: string
            - type: 'null'
        state:
          anyOf:
            - type: string
            - type: 'null'
        country:
          anyOf:
            - type: string
            - type: 'null'
        rawCityCountry:
          anyOf:
            - type: string
            - type: 'null'
        latitude:
          anyOf:
            - type: number
            - type: 'null'
        longitude:
          anyOf:
            - type: number
            - type: 'null'
        formattedAddress:
          anyOf:
            - type: string
            - type: 'null'
        type:
          anyOf:
            - $ref: '#/components/schemas/LocationType'
            - type: 'null'
      required:
        - street1
        - street2
        - postalCode
        - city
        - region
        - state
        - country
        - rawCityCountry
        - latitude
        - longitude
        - formattedAddress
        - type
      id: PrivateLocationDto
    VacancyLocationDto:
      type: object
      properties:
        street1:
          anyOf:
            - type: string
            - type: 'null'
        street2:
          anyOf:
            - type: string
            - type: 'null'
        postalCode:
          anyOf:
            - type: string
            - type: 'null'
        city:
          anyOf:
            - type: string
            - type: 'null'
        region:
          anyOf:
            - type: string
            - type: 'null'
        state:
          anyOf:
            - type: string
            - type: 'null'
        country:
          anyOf:
            - type: string
            - type: 'null'
        latitude:
          anyOf:
            - type: number
            - type: 'null'
        longitude:
          anyOf:
            - type: number
            - type: 'null'
        formattedAddress:
          anyOf:
            - type: string
            - type: 'null'
        type:
          anyOf:
            - $ref: '#/components/schemas/LocationType'
            - type: 'null'
      required:
        - street1
        - street2
        - postalCode
        - city
        - region
        - state
        - country
        - latitude
        - longitude
        - formattedAddress
        - type
      id: PrivateVacancyLocationDto
    DmLanguageEnum:
      type: string
      enum:
        - Afrikaans
        - Albanian
        - Amharic
        - Arabic
        - Armenian
        - Assamese
        - Aymara
        - Azerbaijani
        - Bangla
        - Basque
        - Belarusian
        - Bemba
        - Berber
        - Bislama
        - Bosnian
        - Bulgarian
        - Burman
        - Catalan
        - Chechen
        - Chewa
        - Chinese (Mandarin)
        - Chinese (Cantonese)
        - Chittagonian
        - Croatian
        - Czech
        - Danish
        - Dari
        - Dhivehi
        - Dutch
        - Dzongkha
        - English
        - Estonian
        - Ewe
        - Fijian
        - Filipino
        - Finnish
        - French
        - Galician
        - Georgian
        - German
        - Greek
        - Guarani
        - Gujarati
        - Haitian Creole
        - Hausa
        - Hebrew
        - Hindi
        - Hungarian
        - Icelandic
        - Igbo
        - Indonesian
        - Irish
        - Italian
        - Japanese
        - Kannada
        - Kazakh
        - Khmer
        - Kinyarwanda
        - Kirundi
        - Korean
        - Kurdish
        - Kyrgyz
        - Lao
        - Latvian
        - Lingala
        - Lithuanian
        - Luganda
        - Luxembourgish
        - Macedonian
        - Malagasy
        - Malay
        - Malayalam
        - Maltese
        - Maori
        - Marathi
        - Moldovan
        - Mongolian
        - Montenegrin
        - Ndebele
        - Nepali
        - Norwegian
        - Odia
        - Oromo
        - Pashto
        - Persian
        - Polish
        - Portuguese
        - Punjabi
        - Quechua
        - Romanian
        - Russian
        - Samoan
        - Sango
        - Serbian
        - Sesotho
        - Setswana
        - Shona
        - Sindhi
        - Sinhala
        - Slovak
        - Slovenian
        - Somali
        - Spanish
        - Swahili
        - Swedish
        - Tajik
        - Tamil
        - Telugu
        - Tetum
        - Thai
        - Tigrinya
        - Tok Pisin
        - Tongan
        - Tsonga
        - Tswana
        - Turkish
        - Turkmen
        - Ukrainian
        - Urdu
        - Uzbek
        - Venda
        - Vietnamese
        - Welsh
        - Xhosa
        - Yoruba
        - Zulu
      id: DmLanguageEnum
    DmFluencyEnum:
      type: string
      enum:
        - Elementary proficiency
        - Limited working proficiency
        - Professional working proficiency
        - Full professional proficiency
        - Native or bilingual proficiency
      id: DmFluencyEnum
    ContactEmailDto:
      type: object
      properties:
        email:
          type: string
          format: email
          pattern: >-
            ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
        purpose:
          anyOf:
            - type: string
              enum:
                - personal
                - work
            - type: 'null'
        isPrimary:
          type: boolean
      required:
        - email
        - purpose
        - isPrimary
      id: PrivateContactEmailDto
    ContactPhoneDto:
      type: object
      properties:
        phoneNumber:
          type: string
        purpose:
          anyOf:
            - type: string
              enum:
                - personal
                - work
            - type: 'null'
        isPrimary:
          type: boolean
      required:
        - phoneNumber
        - purpose
        - isPrimary
      id: PrivateContactPhoneDto
    NextTaskDueDto:
      type: object
      properties:
        id:
          type: string
          minLength: 1
        content:
          type: string
        dueDate:
          anyOf:
            - $ref: '#/components/schemas/DateISO'
            - type: 'null'
      required:
        - id
        - content
        - dueDate
      id: PrivateNextTaskDueDto
    LocationType:
      type: string
      enum:
        - primary_home
        - secondary_home
        - primary_work
        - headquarters
        - regional_office
      id: LocationType
  securitySchemes:
    x-api-key:
      type: apiKey
      name: x-api-key
      in: header
      description: >-
        API key for authentication. Get your API key from Settings → API Keys in
        your Spott dashboard.

````