> ## 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. # List Call Tasks > Returns a list of call tasks, most recently scheduled first. Results are paginated using a cursor: pass the `next_cursor` returned by a previous response as the `cursor` query parameter to fetch the next page. When `next_cursor` is `null`, there are no more results. ## OpenAPI ````yaml GET /call-tasks 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: /call-tasks: get: description: >- Returns a list of call tasks, most recently scheduled first. Results are paginated using a cursor: pass the `next_cursor` returned by a previous response as the `cursor` query parameter to fetch the next page. When `next_cursor` is `null`, there are no more results. parameters: - name: status in: query required: false schema: type: string enum: - scheduled - calling - processing - completed - canceled - failed description: Only return call tasks with this status. - name: ext_id in: query required: false schema: type: string description: Only return the call task with this `ext_id`. - name: limit in: query required: false schema: type: integer default: 50 minimum: 1 maximum: 200 description: >- Maximum number of call tasks to return in a single response. Defaults to `50`. Must be between `1` and `200`; values outside this range return a 400. - name: cursor in: query required: false schema: type: string nullable: true description: >- Pagination cursor returned as `next_cursor` in a previous response. Omit on the first request. responses: '200': description: List of call tasks content: application/json: schema: type: object properties: data: type: object properties: call_tasks: type: array items: $ref: '#/components/schemas/CallTask' next_cursor: type: string nullable: true description: >- Cursor to pass as the `cursor` query parameter to fetch the next page. `null` when there are no more results. example: data: call_tasks: - id: 550e8400-e29b-41d4-a716-446655440000 ext_id: appointment-1234 agent_id: 660e8400-e29b-41d4-a716-446655440001 contact_id: 770e8400-e29b-41d4-a716-446655440002 status: scheduled requested_at: '2026-08-03T10:00:00.000Z' scheduled_at: '2026-08-03T13:00:00.000Z' expires_at: '2026-08-08T10:00:00.000Z' created_at: '2026-08-01T09:12:44.000Z' completed_at: null canceled_at: null cancel_requested_at: null attempts: [] next_cursor: null '400': description: Invalid query parameter or cursor content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: CallTask: type: object required: - id - ext_id - agent_id - contact_id - status - requested_at - scheduled_at - expires_at - created_at - completed_at - canceled_at - cancel_requested_at - attempts description: >- An outbound call you asked a voice agent to place, with one entry in `attempts` for each attempt at reaching the contact. properties: id: type: string format: uuid description: Unique identifier of the call task ext_id: type: string nullable: true description: >- Your own identifier for the call task, or `null` if you did not provide one agent_id: type: string format: uuid description: ID of the voice agent placing the call contact_id: type: string format: uuid description: ID of the contact being called status: type: string enum: - scheduled - calling - processing - completed - canceled - failed description: >- Status of the call task: `scheduled` when it is waiting to be called (including while it waits to be retried), `calling` while a call is being placed, `processing` once a call has ended and is being analyzed, and `completed`, `canceled` and `failed` once it is done. A `failed` task will not be called again; the reason is on its last attempt. requested_at: type: string format: date-time description: The earliest time the call may be placed, as you requested it scheduled_at: type: string format: date-time description: >- The time the call is currently scheduled for: the first moment at or after `requested_at` that falls within the agent's calling hours. It moves when the task is rescheduled or is due to be retried. expires_at: type: string format: date-time description: The time past which the call is no longer placed created_at: type: string format: date-time description: When the call task was created completed_at: type: string format: date-time nullable: true description: When the call task completed, or `null` if it has not canceled_at: type: string format: date-time nullable: true description: When the call task was canceled, or `null` if it was not cancel_requested_at: type: string format: date-time nullable: true description: >- When a cancellation was requested while a call was already under way, or `null` attempts: type: array description: One entry per attempt at reaching the contact, oldest first items: $ref: '#/components/schemas/CallTaskAttempt' Error: required: - error - message type: object properties: error: type: integer format: int32 message: type: string CallTaskAttempt: type: object required: - attempt_number - started_at - result - error description: >- One attempt at reaching the contact: when it started, how it ended, and why. Attempts where no call was placed at all — for example because the contact has no phone number — are included, with a `not_dialed` result. properties: attempt_number: type: integer description: Position of this attempt in the task's attempts, starting at 1 started_at: type: string format: date-time description: When the attempt started result: type: string nullable: true enum: - contacted - no_contact - unknown - no_answer - busy - failed - not_dialed description: >- How the attempt ended, or `null` while it is still in progress. The call connected on `contacted` (a person was on the line), `no_contact` (nobody engaged, for example voicemail) and `unknown` (what came of it was never established). The call never connected on `no_answer` (the phone rang out), `busy` and `failed` (the call could not be completed). On `not_dialed` no call was placed at all, and `error` says what stopped it. error: type: object nullable: true required: - code - message description: >- Why the attempt produced no conversation, or `null` when there is nothing to report properties: code: type: string enum: - feature_disabled - agent_calling_disabled - no_phone_number - agent_number_missing - agent_unavailable - no_calling_window - dial_failed - call_setup_failed - workflow_lost - retries_exhausted - expired - window_past_expiry description: >- Stable code to group errors by. Nothing was set up to call with on `feature_disabled`, `agent_calling_disabled`, `no_phone_number`, `agent_number_missing`, `agent_unavailable` and `no_calling_window`; the call was placed but did not work out on `dial_failed`, `call_setup_failed` and `workflow_lost`; and the task ran out of retries or time on `retries_exhausted`, `expired` and `window_past_expiry`. message: type: string description: Human-readable detail about what went wrong securitySchemes: bearerAuth: type: http scheme: bearer ````