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

# Fetch Job Type

> Fetches the full job type configuration referenced by the provided job type ID.



## OpenAPI

````yaml GET /job-types/{JOB_TYPE_ID}
openapi: 3.0.1
info:
  title: Alpharun API
  description: Alpharun REST API reference
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.alpharun.com/api/v1
security:
  - bearerAuth: []
paths:
  /job-types/{JOB_TYPE_ID}:
    get:
      summary: Fetch a job type
      description: >-
        Fetches the full job type configuration referenced by the provided job
        type ID.
      parameters:
        - name: JOB_TYPE_ID
          in: path
          description: The ID of the job type to fetch.
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Job type retrieved successfully
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    $ref: '#/components/schemas/JobTypeResponse'
              example:
                data:
                  job_type:
                    id: 91f3c3e7-2b1d-4461-a4a1-b4f6eb8480bf
                    name: Store Manager
                    job_description: >-
                      Lead store operations, coach associates, and deliver a
                      consistent customer experience.
                    ai_interviewer_guidance: >-
                      Ask follow-up questions about leadership experience and
                      scheduling availability.
                    qualifications:
                      - Retail leadership experience
                      - Weekend availability
                    resume_collection_type: before_interview
                    should_force_fullscreen: true
                    should_record_video: true
        '401':
          description: Unauthorized - Invalid or missing API key
        '404':
          description: Job type not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
components:
  schemas:
    JobTypeResponse:
      type: object
      required:
        - job_type
      properties:
        job_type:
          $ref: '#/components/schemas/JobType'
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
    JobType:
      type: object
      required:
        - id
        - name
        - job_description
        - ai_interviewer_guidance
        - qualifications
        - resume_collection_type
        - should_force_fullscreen
        - should_record_video
      properties:
        id:
          type: string
          format: uuid
          description: The ID of the job type.
        name:
          type: string
          description: The name of the job type.
        job_description:
          type: string
          description: The job description used by the AI interviewer.
        ai_interviewer_guidance:
          type: string
          nullable: true
          description: Additional guidance for the AI interviewer.
        qualifications:
          type: array
          items:
            type: string
          description: Assessment qualifications configured for this job type.
        resume_collection_type:
          type: string
          nullable: true
          enum:
            - after_interview
            - before_interview
          description: When candidates are prompted to provide a resume.
        should_force_fullscreen:
          type: boolean
          description: Whether the interview experience requires fullscreen mode.
        should_record_video:
          type: boolean
          description: Whether interviews for this job type record video.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````