> ## 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 a job > Returns one job with its resolved scheduling settings and job-stage information. The job must belong to the authenticated organization or the request returns not found. **Beta**: this endpoint may change or be removed without notice while in beta. There is no compatibility promise until it reaches general availability. ## OpenAPI ````yaml /openapi.json get /v1/jobs/{jobId} 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/jobs/{jobId}: get: tags: - Job summary: Get a job description: >- Returns one job with its resolved scheduling settings and job-stage information. The job must belong to the authenticated organization or the request returns not found. operationId: getJob parameters: - schema: type: string pattern: >- ^(?:job_)?(?:[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: >- a job 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: job_a1b2c3d4e5f64789a1b2c3d4e5f64789 required: true name: jobId in: path responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/JobDetail' '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: JobDetail: allOf: - $ref: '#/components/schemas/Job' - type: object properties: settings: $ref: '#/components/schemas/JobSettings' required: - settings 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 Job: type: object properties: id: type: string pattern: ^job_[0-9a-f]{32}$ description: >- Canonical job ID (job_ followed by 32 lowercase hexadecimal UUID characters). example: job_a1b2c3d4e5f64789a1b2c3d4e5f64789 name: type: string status: type: string enum: - DRAFT - OPEN - CLOSED confidential: type: boolean locations: type: array items: type: string hiring_team: type: array items: type: object properties: role: type: string enum: - HIRING_MANAGER - RECRUITER - COORDINATOR - SOURCER employee: 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 required: - id - name required: - role - employee ats: type: - object - 'null' properties: type: type: string enum: - GREENHOUSE - ASHBY - LEVER - WORKDAY - SMARTRECRUITERS - GEM - KOMBO id: type: string required: - type - id 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 - status - confidential - locations - hiring_team - ats - created_at - updated_at JobSettings: type: object properties: interview_name_setting: type: - object - 'null' properties: is_custom: type: boolean show_interview_name: type: boolean is_locked: type: boolean level: type: - string - 'null' enum: - ORG - EMPLOYEE - JOB - JOB_STAGE required: - is_custom - show_interview_name - is_locked - level interviewer_info_setting: type: - object - 'null' properties: is_custom: type: boolean can_show_info: type: boolean can_show_full_name: type: boolean can_show_job_title: type: boolean can_show_linkedin: type: boolean can_show_email: type: boolean can_show_profile_picture: type: boolean can_show_pronouns: type: boolean can_show_bio: type: boolean is_locked: type: boolean level: type: - string - 'null' enum: - ORG - EMPLOYEE - JOB - JOB_STAGE required: - is_custom - can_show_info - can_show_full_name - can_show_job_title - can_show_linkedin - can_show_email - can_show_profile_picture - can_show_pronouns - can_show_bio - is_locked - level recruiting_team_contact_info_setting: type: - object - 'null' properties: is_custom: type: boolean show_recruiter: type: boolean show_coordinator: type: boolean can_show_job_title: type: boolean can_show_linkedin: type: boolean can_show_profile_picture: type: boolean can_show_pronouns: type: boolean can_show_bio: type: boolean can_show_phone: type: boolean is_locked: type: boolean level: type: - string - 'null' enum: - ORG - EMPLOYEE - JOB - JOB_STAGE required: - is_custom - show_recruiter - show_coordinator - can_show_job_title - can_show_linkedin - can_show_profile_picture - can_show_pronouns - can_show_bio - can_show_phone - is_locked - level default_task_queue_id: type: - string - 'null' pattern: ^que_[0-9a-f]{32}$ description: >- Canonical task queue ID (que_ followed by 32 lowercase hexadecimal UUID characters). example: que_a1b2c3d4e5f64789a1b2c3d4e5f64789 remote_ats_hiring_process: type: - object - 'null' properties: ats_id: type: - string - 'null' name: type: - string - 'null' status: type: string enum: - NOT_SET - SET - DELETED - MISMATCH required: - ats_id - name - status locale: type: - string - 'null' required: - interview_name_setting - interviewer_info_setting - recruiting_team_contact_info_setting - default_task_queue_id - remote_ats_hiring_process - locale securitySchemes: bearerAuth: type: http scheme: bearer description: API tokens are passed as Bearer tokens. ````