---
title: "Get scheduled callback"
method: GET
path: "/api/v4/tasks/scheduled_callbacks/{scheduled_callback_id}"
tags: ["Tasks"]
---

# Get scheduled callback

`GET /api/v4/tasks/scheduled_callbacks/{scheduled_callback_id}`

## Request

- Base URL: `https://{cluster_id}.voiso.com`
- URL: `https://{cluster_id}.voiso.com/api/v4/tasks/scheduled_callbacks/{scheduled_callback_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/voiso/apis/voiso-api/docs/api/v4/tasks/scheduled_callbacks/:scheduled_callback_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a scheduled callback by ID.

## Path parameters

- `scheduled_callback_id` integer, required

## Response `200`

OK

- object
  - `scheduled_callback` ScheduledCallback
    - `id` integer: The unique identifier of the scheduled callback.
    - `phone_number` string: The phone number to call back.
    - `scheduled_at` string, date-time: The time of the callback in ISO8601 format.
    - `user` UserShort
      - `id` integer: The unique identifier of the user.
      - `name` string: The name of the user.
      - `email` string, email: The email address of the user.
    - `caller_id_group` CallerIDGroupShort: A group of Caller IDs that control which phone number is shown when dialing.
      - `id` integer: The unique identifier of the caller ID group
      - `name` string: The name of the caller ID group.
    - `note` string, nullable: Notes provided for the callback.
    - `related_call` object, nullable
      - `id` string, uuid: Identifier of the related call.
    - `source` object, nullable
      - `system` string: External system that initiated the callback.
      - `account_id` string: Contact identifier in the external system.
    - `status` 'pending' | 'in_progress' | 'completed' | 'failed' | 'in_failover': The current status of the scheduled callback.
    - `created_at` string, date-time: Timestamp when the scheduled callback was created (ISO 8601).
    - `updated_at` string, date-time: Timestamp when the scheduled callback was last updated (ISO 8601).

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `429`: Too many requests

---

[API](https://skmtc.dev/voiso/apis/voiso-api.md) - [All operations](https://skmtc.dev/voiso/apis/voiso-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voiso/apis/voiso-api/revisions/5a6ea146bd21?raw)