CallList

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/twilio/main/json-schema/twilio-call-list-schema.json",
  "title": "CallList",
  "x-generated": "2026-10-08",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/twilio-calls-api-openapi.yml#/components/schemas/CallList",
  "type": "object",
  "properties": {
    "calls": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Call"
      }
    },
    "first_page_uri": {
      "type": "string"
    },
    "next_page_uri": {
      "type": "string"
    },
    "previous_page_uri": {
      "type": "string"
    },
    "page": {
      "type": "integer"
    },
    "page_size": {
      "type": "integer"
    },
    "uri": {
      "type": "string"
    }
  },
  "$defs": {
    "Call": {
      "type": "object",
      "properties": {
        "sid": {
          "type": "string",
          "pattern": "^CA[0-9a-fA-F]{32}$",
          "description": "Unique identifier for the call"
        },
        "account_sid": {
          "type": "string",
          "pattern": "^AC[0-9a-fA-F]{32}$"
        },
        "parent_call_sid": {
          "type": "string",
          "description": "SID of the parent call (for child legs)"
        },
        "to": {
          "type": "string",
          "description": "Phone number or SIP URI that received the call"
        },
        "to_formatted": {
          "type": "string",
          "description": "Formatted version of the To number"
        },
        "from": {
          "type": "string",
          "description": "Phone number or client ID that made the call"
        },
        "from_formatted": {
          "type": "string",
          "description": "Formatted version of the From number"
        },
        "phone_number_sid": {
          "type": "string",
          "description": "SID of the incoming phone number"
        },
        "status": {
          "type": "string",
          "enum": [
            "queued",
            "ringing",
            "in-progress",
            "canceled",
            "completed",
            "failed",
            "busy",
            "no-answer"
          ],
          "description": "Current status of the call"
        },
        "direction": {
          "type": "string",
          "enum": [
            "inbound",
            "outbound-api",
            "outbound-dial"
          ],
          "description": "Direction of the call"
        },
        "price": {
          "type": "string",
          "description": "Price of the call"
        },
        "price_unit": {
          "type": "string",
          "description": "Currency unit for the price"
        },
        "duration": {
          "type": "string",
          "description": "Duration of the call in seconds"
        },
        "start_time": {
          "type": "string",
          "format": "date-time",
          "description": "When the call started"
        },
        "end_time": {
          "type": "string",
          "format": "date-time",
          "description": "When the call ended"
        },
        "date_created": {
          "type": "string",
          "format": "date-time"
        },
        "date_updated": {
          "type": "string",
          "format": "date-time"
        },
        "answered_by": {
          "type": "string",
          "enum": [
            "human",
            "machine"
          ],
          "description": "Whether the call was answered by a human or machine"
        },
        "caller_name": {
          "type": "string",
          "description": "Caller name if available via CNAM lookup"
        },
        "forwarded_from": {
          "type": "string",
          "description": "Number that forwarded the call"
        },
        "group_sid": {
          "type": "string",
          "description": "SID that identifies the call group"
        },
        "uri": {
          "type": "string"
        },
        "api_version": {
          "type": "string"
        },
        "subresource_uris": {
          "type": "object",
          "properties": {
            "recordings": {
              "type": "string"
            },
            "notifications": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}