TWtwilio
TwilioInsightsAsync

Retrieve a list of asynchronous queries

Changed on

Returns a paginated list of asynchronous query operations for the authenticated account. Optionally filter by status.

get/v3/InsightsDomains/Conversations/QueryJobs

Request

  • Base URL
    https://insights.twilio.com
  • URL
    https://insights.twilio.com/v3/InsightsDomains/Conversations/QueryJobs
  • Auth
    HTTP basic

Query parameters

pageSizeinteger

The maximum number of resources to return

pageTokenstring

Token for pagination

status'PENDING' | 'RUNNING' | 'CANCELLED' | 'COMPLETED' | 'FAILED'

The valid status values for long-running operations.

The operation status to filter results by.

Response

Paginated list of async query operations

Example response

{
  "items": [
    {
      "operationId": "proc_job_01h9d8r0vte3hz8tykdj329t7r",
      "statusUrl": "https://insights.twilio.com/v3/InsightsDomains/Conversations/QueryJobs/proc_job_01h9d8r0vte3hz8tykdj329t7r",
      "createdAt": "2026-05-25T14:30:00Z",
      "completedAt": "2026-05-25T14:32:17Z",
      "error": {
        "code": 50001,
        "message": "Query execution timeout exceeded",
        "httpStatusCode": 504,
        "detail": "Query exceeded the 120s execution limit."
      },
      "resultUrl": "https://insights.twilio.com/v3/InsightsDomains/Conversations/QueryJobs/proc_job_01h9d8r0vte3hz8tykdj329t7r/Results",
      "resultId": "proc_job_01h9d8r0vte3hz8tykdj329t7r",
      "resultRetentionPeriod": "P7D"
    }
  ],
  "meta": {
    "key": "items",
    "pageSize": 20,
    "previousToken": "eyJwYWdlIjowLCJxdWVyeSI6ImJvb2tzIn0=",
    "nextToken": "eyJwYWdlIjoyLCJxdWVyeSI6ImJvb2tzIn0="
  }
}

Changes