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

# Get an interviewer

> Returns an interviewer profile with load limits, pause state, work hours, attributes, and interview-module memberships. The interviewer must belong to the authenticated organization or the request returns not found.

<Note>**Beta**: this endpoint may change or be removed without notice while in beta. There is no compatibility promise until it reaches general availability.</Note>


## OpenAPI

````yaml /openapi.json get /v1/interviewers/{interviewerId}
openapi: 3.1.0
info:
  title: ModernLoop Platform API
  version: 0.1.0
  description: The ModernLoop Platform API for managing recruiting workflows.
  contact:
    email: support@modernloop.io
servers:
  - url: https://api.modernloop.io
security: []
tags:
  - name: Application
  - name: Candidate
  - name: Interview Event
  - name: Interview Module
  - name: Interviewer
  - name: Job
  - name: Job Stage
  - name: Organization
  - name: Schedule
  - name: Scheduling Task
  - name: Task Queue
  - name: Template
paths:
  /v1/interviewers/{interviewerId}:
    get:
      tags:
        - Interviewer
      summary: Get an interviewer
      description: >-
        Returns an interviewer profile with load limits, pause state, work
        hours, attributes, and interview-module memberships. The interviewer
        must belong to the authenticated organization or the request returns not
        found.
      operationId: getInterviewer
      parameters:
        - schema:
            type: string
            pattern: >-
              ^(?:emp_)?(?:[0-9a-fA-F]{32}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
            description: >-
              an employee ID. Accepts the canonical prefixed compact UUID, a
              prefixed dashed UUID, a bare dashed UUID, or a bare compact UUID;
              input is case-insensitive.
            example: emp_a1b2c3d4e5f64789a1b2c3d4e5f64789
          required: true
          name: interviewerId
          in: path
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Interviewer'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '410':
          description: Gone
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    Interviewer:
      type: object
      properties:
        id:
          type: string
          pattern: ^emp_[0-9a-f]{32}$
          description: >-
            Canonical employee ID (emp_ followed by 32 lowercase hexadecimal
            UUID characters).
          example: emp_a1b2c3d4e5f64789a1b2c3d4e5f64789
        name:
          type: string
        email:
          type: string
          format: email
        title:
          type:
            - string
            - 'null'
        timezone:
          type:
            - string
            - 'null'
        manager_id:
          type:
            - string
            - 'null'
          pattern: ^emp_[0-9a-f]{32}$
          description: >-
            Canonical employee ID (emp_ followed by 32 lowercase hexadecimal
            UUID characters).
          example: emp_a1b2c3d4e5f64789a1b2c3d4e5f64789
        ats:
          type:
            - object
            - 'null'
          properties:
            type:
              type: string
              enum:
                - GREENHOUSE
                - ASHBY
                - LEVER
                - WORKDAY
                - SMARTRECRUITERS
                - GEM
                - KOMBO
            id:
              type: string
          required:
            - type
            - id
        load:
          type: object
          properties:
            daily_interviews:
              type: integer
            daily_limit:
              type: integer
            daily_load_limit:
              type:
                - object
                - 'null'
              properties:
                source:
                  type: string
                  enum:
                    - ORG
                    - INTERVIEWER
                limit:
                  type: integer
                  exclusiveMinimum: 0
                type:
                  type: string
                  enum:
                    - NUMBER_OF_INTERVIEWS
                    - NUMBER_OF_MINUTES
              required:
                - source
                - limit
                - type
            weekly_interviews:
              type: integer
            weekly_limit:
              type: integer
            weekly_load_limit:
              type:
                - object
                - 'null'
              properties:
                source:
                  type: string
                  enum:
                    - ORG
                    - INTERVIEWER
                limit:
                  type: integer
                  exclusiveMinimum: 0
                type:
                  type: string
                  enum:
                    - NUMBER_OF_INTERVIEWS
                    - NUMBER_OF_MINUTES
              required:
                - source
                - limit
                - type
          required:
            - daily_interviews
            - daily_limit
            - daily_load_limit
            - weekly_interviews
            - weekly_limit
            - weekly_load_limit
        paused:
          type: object
          properties:
            is_paused:
              type: boolean
            until:
              type:
                - string
                - 'null'
              format: date-time
              description: ISO 8601 timestamp.
          required:
            - is_paused
            - until
        pause_dates:
          type: array
          items:
            type: object
            properties:
              start_at:
                type: string
                format: date-time
                description: ISO 8601 timestamp.
              end_at:
                type: string
                format: date-time
                description: ISO 8601 timestamp.
            required:
              - start_at
              - end_at
        work_hours:
          type: object
          properties:
            source:
              type: string
              enum:
                - ORG
                - INTERVIEWER
            blocks:
              type: array
              items:
                type: object
                properties:
                  day:
                    type: string
                  start:
                    type: string
                  end:
                    type: string
                required:
                  - day
                  - start
                  - end
          required:
            - source
            - blocks
        attributes:
          type: array
          items:
            type: object
            properties:
              attribute_name:
                type: object
                properties:
                  id:
                    type: string
                    pattern: ^att_[0-9a-f]{32}$
                    description: >-
                      Canonical interviewer attribute ID (att_ followed by 32
                      lowercase hexadecimal UUID characters).
                    example: att_a1b2c3d4e5f64789a1b2c3d4e5f64789
                  name:
                    type: string
                  type:
                    type: string
                    enum:
                      - DEPARTMENT
                      - TEAM
                      - LEVEL
                      - LOCATION
                      - COUNTRY
                      - CUSTOM
                required:
                  - id
                  - name
                  - type
              values:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      pattern: ^atv_[0-9a-f]{32}$
                      description: >-
                        Canonical interviewer attribute value ID (atv_ followed
                        by 32 lowercase hexadecimal UUID characters).
                      example: atv_a1b2c3d4e5f64789a1b2c3d4e5f64789
                    name:
                      type: string
                  required:
                    - id
                    - name
            required:
              - attribute_name
              - values
        modules:
          type: array
          items:
            type: object
            properties:
              module:
                type: object
                properties:
                  id:
                    type: string
                    pattern: ^mod_[0-9a-f]{32}$
                    description: >-
                      Canonical interview module ID (mod_ followed by 32
                      lowercase hexadecimal UUID characters).
                    example: mod_a1b2c3d4e5f64789a1b2c3d4e5f64789
                  name:
                    type: string
                required:
                  - id
                  - name
              training_status:
                type: string
                enum:
                  - TRAINED
                  - SHADOW
                  - REVERSE_SHADOW
              is_paused:
                type: boolean
            required:
              - module
              - training_status
              - is_paused
        created_at:
          type: string
          format: date-time
          description: ISO 8601 timestamp.
        updated_at:
          type: string
          format: date-time
          description: ISO 8601 timestamp.
      required:
        - id
        - name
        - email
        - title
        - timezone
        - manager_id
        - ats
        - load
        - paused
        - pause_dates
        - work_hours
        - attributes
        - modules
        - created_at
        - updated_at
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - UNAUTHENTICATED
                - API_ACCESS_DISABLED
                - SCOPE_MISSING
                - INSUFFICIENT_SCOPE
                - VALIDATION_FAILED
                - INVALID_CURSOR
                - PAYLOAD_TOO_LARGE
                - NOT_FOUND
                - NOT_FOUND_MAY_BE_SYNCING
                - CANDIDATE_ANONYMIZED
                - TASK_STAGE_NOT_SCHEDULABLE
                - DUPLICATE_REQUEST_OPEN
                - IDEMPOTENCY_KEY_REQUIRED
                - IDEMPOTENCY_KEY_REUSED
                - PREVIEW_EXPIRED
                - PREVIEW_STALE
                - RATE_LIMITED
                - CONFLICT
                - NOT_IMPLEMENTED
                - INTERNAL
                - UPSTREAM_TIMEOUT
            message:
              type: string
            docs_url:
              type: string
              format: uri
          required:
            - code
            - message
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API tokens are passed as Bearer tokens.

````