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

> Fetches the job opening referenced by the provided job opening ID



## OpenAPI

````yaml GET /job-openings/{JOB_OPENING_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-openings/{JOB_OPENING_ID}:
    get:
      summary: Fetch a job opening
      description: Fetches the job opening referenced by the provided job opening ID
      parameters:
        - name: JOB_OPENING_ID
          in: path
          description: The ID of the job opening to fetch
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Job opening created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/JobOpeningResponse'
        '400':
          description: Invalid request payload
        '401':
          description: Unauthorized - Invalid or missing API key
        '409':
          description: Conflict - Job opening name or job type name already exists
        '500':
          description: Internal server error
components:
  schemas:
    JobOpeningResponse:
      type: object
      properties:
        job_opening:
          type: object
          properties:
            id:
              type: string
              description: The ID of the job opening
            name:
              type: string
              description: The name of the job opening
            status:
              type: string
              enum:
                - live
                - paused
              description: The status of the job opening
            interview_link:
              type: string
              description: The link to the interview for this job opening
            link_access:
              type: object
              properties:
                restricted:
                  type: boolean
                  description: >-
                    Whether the link to the interview is restricted to
                    pre-registered candidates only
            location:
              type: object
              properties:
                description:
                  type: string
                  description: The location of the job opening
            pay:
              type: object
              properties:
                description:
                  type: string
                  description: The pay of the job opening
            hours:
              type: object
              properties:
                description:
                  type: string
                  description: The hours of the job opening
            questions:
              type: array
              items:
                type: string
              description: The questions of the job opening
            owner_emails:
              type: array
              items:
                type: string
                format: email
              description: Array of teammate email addresses for job opening owners.
            job_type:
              type: object
              properties:
                id:
                  type: string
                  description: The ID of the job opening
                name:
                  type: string
                  description: The name of the job type
                job_description:
                  type: string
                  description: The job description of the job type
                ai_interviewer_guidance:
                  type: string
                  description: The AI interviewer guidance of the job type
                qualifications:
                  type: array
                  items:
                    type: string
                  description: The qualifications of the job type
                resume_collection_type:
                  type: string
                  enum:
                    - after_interview
                    - before_interview
                  description: The resume collection type of the job type
                should_force_fullscreen:
                  type: boolean
                  description: Whether to force fullscreen mode
                should_record_video:
                  type: boolean
                  description: Whether to record video
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````