Phones - Calls

List pending scheduled calls

List all pending scheduled calls for the company — calls with status "scheduled" or "to_be_processed" whose scheduled time is in the future, sorted by scheduled time ascending.

Filters (all optional):

  • agentId: Only calls assigned to this agent
  • phoneNumber: Only calls to this destination number (matched with and without country-code prefix)
  • limit: Maximum results (default 100, max 500)

Response: Each entry includes the call id (use it with the cancel-scheduled endpoint), destination number, scheduled time, agent, VoIP phone, AI context, dynamic variables, and retry counters.

Typical Workflow:

  1. Schedule calls via initiate-call (scheduledAt) or initiate-bulk
  2. Call this endpoint to review what is queued
  3. Cancel unwanted calls via the cancel-scheduled endpoint
post/api/v1/phones/calls/scheduled

Request

  • Base URL: https://api.voicelogica.ai
  • URL: https://api.voicelogica.ai/api/v1/phones/calls/scheduled
  • Auth: API key in header x-api-key

Headers

x-api-keystring required

Your API key for authentication. Required for all endpoints.

x-company-idstring

Optional company ID for resellers. When provided, the API request will operate on behalf of the specified subsidiary company. The API key must have access to the specified company.

Request body

agentIdstring

Filter scheduled calls by agent ID

phoneNumberstring

Filter scheduled calls by destination phone number

limitnumber

Maximum number of scheduled calls to return (default: 100, max: 500)

Response

Scheduled calls retrieved

idstring required

Call ID (use this to cancel the call)

phoneNumberstring required

Destination phone number

scheduledAtstring date-time required

When the call is scheduled to be placed

agentIdstring

Agent ID handling the call

voipPhoneIdstring

VoIP phone ID used for the call (legacy)

sipTrunkIdstring

SIP trunk ID used for the call

contextForAistring

AI context for the call

dynamicVariablesobject

Dynamic variables for the call

retriesnumber

Current retry count

maxRetriesnumber

Maximum retries allowed

createdAtstring date-time required

When the call was created

Example response

[
  {
    "id": "507f1f77bcf86cd799439011",
    "phoneNumber": "+306912345678",
    "scheduledAt": "2026-03-21T14:00:00.000Z",
    "agentId": "507f1f77bcf86cd799439012",
    "voipPhoneId": "507f1f77bcf86cd799439013",
    "contextForAi": "Customer requested a callback about their pending order.",
    "dynamicVariables": {
      "customer_name": "John Doe",
      "order_id": "ORD-123"
    },
    "retries": 0,
    "maxRetries": 2,
    "createdAt": "2026-03-20T09:15:00.000Z"
  }
]

Changes

No recorded changes to this operation across all 2 revisions of this API.