> ## 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 scheduling task > Returns one scheduling task with its application, stage, assignee, queue, tags, flags, delegation, notes, and timing metadata. The task 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/tasks/{taskId} 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/tasks/{taskId}: get: tags: - Scheduling Task summary: Get a scheduling task description: >- Returns one scheduling task with its application, stage, assignee, queue, tags, flags, delegation, notes, and timing metadata. The task must belong to the authenticated organization or the request returns not found. operationId: getSchedulingTask parameters: - schema: type: string pattern: >- ^(?:tsk_)?(?:[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 task 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: tsk_a1b2c3d4e5f64789a1b2c3d4e5f64789 required: true name: taskId in: path responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/SchedulingTask' '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: SchedulingTask: type: object properties: id: type: string pattern: ^tsk_[0-9a-f]{32}$ description: >- Canonical task ID (tsk_ followed by 32 lowercase hexadecimal UUID characters). example: tsk_a1b2c3d4e5f64789a1b2c3d4e5f64789 application: type: object properties: id: type: string pattern: ^app_[0-9a-f]{32}$ description: >- Canonical application ID (app_ followed by 32 lowercase hexadecimal UUID characters). example: app_a1b2c3d4e5f64789a1b2c3d4e5f64789 candidate: type: object properties: id: type: string pattern: ^can_[0-9a-f]{32}$ description: >- Canonical candidate ID (can_ followed by 32 lowercase hexadecimal UUID characters). example: can_a1b2c3d4e5f64789a1b2c3d4e5f64789 name: type: string required: - id - name 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 required: - id - name required: - id - candidate - job job_stage: type: object properties: id: type: string pattern: ^stg_[0-9a-f]{32}$ description: >- Canonical job stage ID (stg_ followed by 32 lowercase hexadecimal UUID characters). example: stg_a1b2c3d4e5f64789a1b2c3d4e5f64789 name: type: string required: - id - name status: type: string enum: - NEEDS_AVAILABILITY - WAITING_FOR_CANDIDATE - READY_TO_SCHEDULE - READY_TO_RESCHEDULE - HOLD - READY_TO_SEND_TO_CANDIDATE - SCHEDULED - COMPLETED - CANCELED - NEEDS_DEBRIEF is_urgent: type: boolean assignee: type: - object - 'null' 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 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 tags: type: array items: type: string flags: type: array items: type: object properties: code: type: string message: type: string raised_at: type: string format: date-time description: ISO 8601 timestamp. required: - code - message - raised_at is_debrief_required: type: boolean delegation: type: object properties: type: type: string enum: - NONE - AGENT status: type: string enum: - NONE - QUEUED - ACTIVE - WAITING_ON_CANDIDATE - WAITING_ON_TEAM - COMPLETED - STOPPED required: - type - status notes: type: array items: type: object properties: id: type: string author: 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 body: type: string created_at: type: string format: date-time description: ISO 8601 timestamp. required: - id - author - body - created_at created_at: type: string format: date-time description: ISO 8601 timestamp. updated_at: type: string format: date-time description: ISO 8601 timestamp. app_url: type: string format: uri required: - id - application - job_stage - status - is_urgent - assignee - queue_id - tags - flags - is_debrief_required - delegation - notes - created_at - updated_at - app_url 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. ````