Retrieve a paginated list of calls with optional filtering and sorting.
This endpoint allows querying call history with various filters including time ranges
and specific AI agents. Results are paginated for efficient data retrieval.
GET
/
v1
/
calls
/
List Calls
curl --request GET \ --url https://api.example.com/v1/calls/
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Verbex Docs","colors":{"primary":"#0D9373","light":"#07C983","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/hishabsingaporepteltd/hKDJJlbuwj-_7GRI/light.png?fit=max\u0026auto=format\u0026n=hKDJJlbuwj-_7GRI\u0026q=85\u0026s=8e51283f8c4e5daa2b06e4c7b010036a","dark":"https://mintcdn.com/hishabsingaporepteltd/Bd-nkhA8cT0nKgAS/dark.png?fit=max\u0026auto=format\u0026n=Bd-nkhA8cT0nKgAS\u0026q=85\u0026s=c7eab5a32b4f7a91d7d0a702fa7aa1d1"},"favicon":"https://mintcdn.com/hishabsingaporepteltd/Bd-nkhA8cT0nKgAS/favicon.png?fit=max\u0026auto=format\u0026n=Bd-nkhA8cT0nKgAS\u0026q=85\u0026s=b848ae01a88c70cb541c5bf4ba708435","navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://console.verbex.ai/dashboard"}},"footer":{"socials":{"discord":"https://discord.gg/9c6b2GAq5t","youtube":"https://www.youtube.com/@verbexadmin","facebook":"https://web.facebook.com/hishabltd","linkedin":"https://www.linkedin.com/company/hishab"}},"fonts":{"heading":{"family":"Poppins-Thin 100"},"body":{"family":"Poppins-Thin 100"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"hishabsingaporepteltd","hasAudioNarration":false,"actualSubdomain":"hishabsingaporepteltd","customDomains":["docs.verbex.ai"],"gitSource":{"type":"github","owner":"verbex-ai","repo":"verbex-platform-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af1615c1bf4ae0260262b72","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API Reference","count":72},{"language":"default","tag":"Documentation","count":45},{"language":"default","tag":"Build Your AI Agent - Step by Step","count":23},{"language":"default","tag":"Knowledge Bases","count":13},{"language":"default","tag":" Connect Tools","count":11},{"language":"default","tag":"Resources","count":6},{"language":"default","tag":"Webhook Subscriptions","count":6},{"language":"default","tag":"Navigating within Verbex","count":5},{"language":"default","tag":" Configure Your AI Agent","count":5},{"language":"default","tag":"AI Agents v2","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/calls/list-calls","slug":"/api-reference/calls/list-calls","pageMetadata":{"title":"List Calls","description":"Retrieve a paginated list of calls with optional filtering and sorting.\n\nThis endpoint allows querying call history with various filters including time ranges\nand specific AI agents. Results are paginated for efficient data retrieval.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/calls/","href":"/api-reference/calls/list-calls","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Retrieve a paginated list of calls with optional filtering and sorting.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"This endpoint allows querying call history with various filters including time ranges\\nand specific AI agents. Results are paginated for efficient data retrieval.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List Calls","description":"Retrieve a paginated list of calls with optional filtering and sorting.\n\nThis endpoint allows querying call history with various filters including time ranges\nand specific AI agents. Results are paginated for efficient data retrieval.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/calls/","href":"/api-reference/calls/list-calls","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Calls"],"summary":"List Calls","description":"Retrieve a paginated list of calls with optional filtering and sorting.\n\nThis endpoint allows querying call history with various filters including time ranges\nand specific AI agents. Results are paginated for efficient data retrieval.","operationId":"list_calls_v1_calls__get","parameters":["7eebc756-747a-4832-8864-4ccce89e624e","93377e1d-8ddc-4711-82fc-031c9f30601f","8ca12795-c3cf-455a-90ba-76b424a92772","796dbc57-b4a3-40f6-ae6a-c8690c70208c","f25ed836-53e2-4656-8ea0-d9481ca6143e","35b501be-8e3a-42dd-9ed1-72daffc55f5b","1f5e279d-92e1-475d-bbdd-68178088df94","72fbe9d2-4269-4254-b373-b9ba79b92c48","9264fe70-a4eb-4162-b3d5-8d0b42a19e5d","18379c7d-9eba-4770-bff9-c11395495616"],"responses":{"200":"110b83ba-f8cc-4f47-bdbc-93ab573cd1ae","400":"f2227d5b-af79-410d-801b-8f9298f7cd8c","401":"44e06bfe-f4fe-48d8-a650-26ef2e1a6183","500":"dc567585-c6bf-4a6c-96d0-85552d5bed02"},"x-unpublished-parameters":{"_note":"Hidden until published. To publish, move these back into `parameters`.","parameters":[{"name":"campaign_id","in":"query","required":false,"description":"Filter calls by campaign ID to retrieve all calls associated with that campaign.","schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id"}}]},"method":"get","type":"path","servers":[],"security":[],"path":"/v1/calls/","baseUrlOptions":[],"title":"List Calls","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"7eebc756-747a-4832-8864-4ccce89e624e":{"name":"ai_agent_ids","in":"query","required":false,"schema":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Ai Agent Ids","description":"Filter by one or more AI agent IDs","uniqueKey":"oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Ai Agent Ids","description":"Filter by one or more AI agent IDs","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string[] | null"},"description":"Filter by one or more AI agent IDs"},"93377e1d-8ddc-4711-82fc-031c9f30601f":{"name":"batch_call_id","in":"query","required":false,"description":"Filter calls by a specific batch call ID to retrieve all calls associated with that batch.","schema":{"oneOf":[{"type":"string","title":"Batch Call Id","description":"Filter calls by a specific batch call ID to retrieve all calls associated with that batch.","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Batch Call Id","description":"Filter calls by a specific batch call ID to retrieve all calls associated with that batch.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"}},"8ca12795-c3cf-455a-90ba-76b424a92772":{"name":"call_id","in":"query","required":false,"description":"Filter by a specific call ID","schema":{"oneOf":[{"type":"string","title":"Call Id","description":"Filter by a specific call ID","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Call Id","description":"Filter by a specific call ID","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"}},"796dbc57-b4a3-40f6-ae6a-c8690c70208c":{"name":"start_time_before","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Start Time Before","description":"Accepts a date (`YYYY-MM-DD`) or an ISO-8601 instant (`2026-06-15T18:00:00Z`). A date-only value is expanded to the end of that day in UTC.","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Start Time Before","description":"Accepts a date (`YYYY-MM-DD`) or an ISO-8601 instant (`2026-06-15T18:00:00Z`). A date-only value is expanded to the end of that day in UTC.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Accepts a date (`YYYY-MM-DD`) or an ISO-8601 instant (`2026-06-15T18:00:00Z`). A date-only value is expanded to the end of that day in UTC."},"f25ed836-53e2-4656-8ea0-d9481ca6143e":{"name":"start_time_after","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Start Time After","description":"Accepts a date (`YYYY-MM-DD`) or an ISO-8601 instant (`2026-06-15T18:00:00Z`). A date-only value is expanded to the start of that day in UTC.","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Start Time After","description":"Accepts a date (`YYYY-MM-DD`) or an ISO-8601 instant (`2026-06-15T18:00:00Z`). A date-only value is expanded to the start of that day in UTC.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Accepts a date (`YYYY-MM-DD`) or an ISO-8601 instant (`2026-06-15T18:00:00Z`). A date-only value is expanded to the start of that day in UTC."},"35b501be-8e3a-42dd-9ed1-72daffc55f5b":{"name":"end_time_before","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"End Time Before","description":"Accepts a date (`YYYY-MM-DD`) or an ISO-8601 instant (`2026-06-15T18:00:00Z`). A date-only value is expanded to the end of that day in UTC.","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"End Time Before","description":"Accepts a date (`YYYY-MM-DD`) or an ISO-8601 instant (`2026-06-15T18:00:00Z`). A date-only value is expanded to the end of that day in UTC.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Accepts a date (`YYYY-MM-DD`) or an ISO-8601 instant (`2026-06-15T18:00:00Z`). A date-only value is expanded to the end of that day in UTC."},"1f5e279d-92e1-475d-bbdd-68178088df94":{"name":"end_time_after","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"End Time After","description":"Accepts a date (`YYYY-MM-DD`) or an ISO-8601 instant (`2026-06-15T18:00:00Z`). A date-only value is expanded to the start of that day in UTC.","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"End Time After","description":"Accepts a date (`YYYY-MM-DD`) or an ISO-8601 instant (`2026-06-15T18:00:00Z`). A date-only value is expanded to the start of that day in UTC.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Accepts a date (`YYYY-MM-DD`) or an ISO-8601 instant (`2026-06-15T18:00:00Z`). A date-only value is expanded to the start of that day in UTC."},"72fbe9d2-4269-4254-b373-b9ba79b92c48":{"name":"sort_direction","in":"query","required":true,"description":"Sort order by call start time: `asc` or `desc`","schema":{"type":"string","enum":["asc","desc"],"title":"Sort Direction","isRequired":true,"description":"Sort order by call start time: `asc` or `desc`","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"9264fe70-a4eb-4162-b3d5-8d0b42a19e5d":{"name":"page_size","in":"query","required":true,"description":"Number of calls per page (1-100)","schema":{"type":"integer","minimum":1,"maximum":100,"title":"Page Size","isRequired":true,"description":"Number of calls per page (1-100)","uniqueKey":"","typeLabel":"integer"}},"18379c7d-9eba-4770-bff9-c11395495616":{"name":"page_token","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Page Token","description":"Token from `next_page_token` of the previous response, to fetch the next page","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Page Token","description":"Token from `next_page_token` of the previous response, to fetch the next page","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Token from `next_page_token` of the previous response, to fetch the next page"}},"responses":{"110b83ba-f8cc-4f47-bdbc-93ab573cd1ae":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"calls":{"items":{"oneOf":[{"type":"object","title":"WebCallResponse","required":["call_status"],"x-unpublished-properties":{"_note":"Hidden until published. To publish, move these back into `properties`.","campaign_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id","description":"Campaign ID, if the call belongs to a campaign. Omitted when not set."}},"properties":{"call_status":{"type":"string","enum":["registered","ongoing","ended","error","unreachable"],"title":"Call Status","description":"Current status of the call: 'registered' for initialized calls, 'ongoing' for active calls, 'ended' for completed calls, 'error' for failed calls, 'unreachable' when the callee could not be reached","isRequired":true,"uniqueKey":"calls.items.[INDEX].oneOf.0.call_status","typeLabel":"enum\u003cstring>"},"_id":{"type":"string","title":"Id","description":"Unique identifier for the call","uniqueKey":"calls.items.[INDEX].oneOf.0._id","typeLabel":"string"},"ai_agent_id":{"oneOf":[{"type":"string","title":"Ai Agent Id","description":"Identifier of the AI agent handling this call","uniqueKey":"calls.items.[INDEX].oneOf.0.ai_agent_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Ai Agent Id","description":"Identifier of the AI agent handling this call","uniqueKey":"calls.items.[INDEX].oneOf.0.ai_agent_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.0.ai_agent_id","typeLabel":"string | null"},"ai_agent_name":{"oneOf":[{"type":"string","title":"Ai Agent Name","description":"Name of the AI agent handling this call","uniqueKey":"calls.items.[INDEX].oneOf.0.ai_agent_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Ai Agent Name","description":"Name of the AI agent handling this call","uniqueKey":"calls.items.[INDEX].oneOf.0.ai_agent_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.0.ai_agent_name","typeLabel":"string | null"},"override_ai_agent_id":{"oneOf":[{"type":"string","title":"Override Ai Agent Id","description":"Optional identifier for an alternative AI agent handling this call","uniqueKey":"calls.items.[INDEX].oneOf.0.override_ai_agent_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Override Ai Agent Id","description":"Optional identifier for an alternative AI agent handling this call","uniqueKey":"calls.items.[INDEX].oneOf.0.override_ai_agent_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.0.override_ai_agent_id","typeLabel":"string | null"},"metadata":{"oneOf":[{"type":"object","title":"Metadata","description":"Custom key-value pairs storing additional information about the call","additionalProperties":{"type":"string","uniqueKey":"calls.items.[INDEX].oneOf.0.metadata.oneOf.0.additionalProperties","typeLabel":"string"},"uniqueKey":"calls.items.[INDEX].oneOf.0.metadata.oneOf.0","typeLabel":"Metadata · object"},{"type":"null","title":"Metadata","description":"Custom key-value pairs storing additional information about the call","uniqueKey":"calls.items.[INDEX].oneOf.0.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.0.metadata","typeLabel":"Metadata · object | null"},"pia_llm_dynamic_data":{"oneOf":[{"type":"object","title":"Pia Llm Dynamic Data","description":"Dynamic data used by the AI agent during the call","uniqueKey":"calls.items.[INDEX].oneOf.0.pia_llm_dynamic_data.oneOf.0","typeLabel":"Pia Llm Dynamic Data · object"},{"type":"null","title":"Pia Llm Dynamic Data","description":"Dynamic data used by the AI agent during the call","uniqueKey":"calls.items.[INDEX].oneOf.0.pia_llm_dynamic_data.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.0.pia_llm_dynamic_data","typeLabel":"Pia Llm Dynamic Data · object | null"},"call_start_time":{"oneOf":[{"type":"string","title":"Call Start Time","description":"Timestamp when the call was initiated, in UTC","format":"date-time","uniqueKey":"calls.items.[INDEX].oneOf.0.call_start_time.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Call Start Time","description":"Timestamp when the call was initiated, in UTC","uniqueKey":"calls.items.[INDEX].oneOf.0.call_start_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.0.call_start_time","typeLabel":"string\u003cdate-time> | null"},"call_end_time":{"oneOf":[{"type":"string","title":"Call End Time","description":"Timestamp when the call was terminated, in UTC","format":"date-time","uniqueKey":"calls.items.[INDEX].oneOf.0.call_end_time.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Call End Time","description":"Timestamp when the call was terminated, in UTC","uniqueKey":"calls.items.[INDEX].oneOf.0.call_end_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.0.call_end_time","typeLabel":"string\u003cdate-time> | null"},"messages":{"oneOf":[{"type":"array","items":{"properties":{"role":{"type":"string","enum":["agent","user"],"title":"Role","description":"Identifies whether the message is from the AI agent ('agent') or the human user ('user')","isRequired":true,"uniqueKey":"calls.items.[INDEX].oneOf.0.messages.oneOf.0.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"content":{"type":"string","title":"Content","description":"The actual text content of the message exchanged during the conversation","isRequired":true,"uniqueKey":"calls.items.[INDEX].oneOf.0.messages.oneOf.0.items.[INDEX].content","typeLabel":"string"},"started_at":{"oneOf":[{"type":"string","title":"Started At","description":"When this message started, relative to the call or as a timestamp","uniqueKey":"calls.items.[INDEX].oneOf.0.messages.oneOf.0.items.[INDEX].started_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Started At","description":"When this message started, relative to the call or as a timestamp","uniqueKey":"calls.items.[INDEX].oneOf.0.messages.oneOf.0.items.[INDEX].started_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.0.messages.oneOf.0.items.[INDEX].started_at","typeLabel":"string | null"},"ended_at":{"oneOf":[{"type":"string","title":"Ended At","description":"When this message ended, relative to the call or as a timestamp","uniqueKey":"calls.items.[INDEX].oneOf.0.messages.oneOf.0.items.[INDEX].ended_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Ended At","description":"When this message ended, relative to the call or as a timestamp","uniqueKey":"calls.items.[INDEX].oneOf.0.messages.oneOf.0.items.[INDEX].ended_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.0.messages.oneOf.0.items.[INDEX].ended_at","typeLabel":"string | null"}},"type":"object","required":["role","content"],"title":"MessageItem","uniqueKey":"calls.items.[INDEX].oneOf.0.messages.oneOf.0.items.[INDEX]","typeLabel":"MessageItem · object"},"title":"Messages","description":"Chronological list of messages exchanged during the call","uniqueKey":"calls.items.[INDEX].oneOf.0.messages.oneOf.0","typeLabel":"MessageItem · object[]"},{"type":"null","title":"Messages","description":"Chronological list of messages exchanged during the call","uniqueKey":"calls.items.[INDEX].oneOf.0.messages.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.0.messages","typeLabel":"MessageItem · object[] | null"},"recorded_call_audio_url":{"oneOf":[{"type":"string","title":"Recorded Call Audio Url","description":"URL to access the recorded audio file of the call","uniqueKey":"calls.items.[INDEX].oneOf.0.recorded_call_audio_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Recorded Call Audio Url","description":"URL to access the recorded audio file of the call","uniqueKey":"calls.items.[INDEX].oneOf.0.recorded_call_audio_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.0.recorded_call_audio_url","typeLabel":"string | null"},"access_token":{"oneOf":[{"type":"string","title":"Access Token","description":"Security token for accessing call-related resources","uniqueKey":"calls.items.[INDEX].oneOf.0.access_token.oneOf.0","typeLabel":"string"},{"type":"null","title":"Access Token","description":"Security token for accessing call-related resources","uniqueKey":"calls.items.[INDEX].oneOf.0.access_token.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.0.access_token","typeLabel":"string | null"},"call_duration_seconds":{"oneOf":[{"type":"integer","title":"Call Duration Seconds","description":"Duration of the call in seconds","uniqueKey":"calls.items.[INDEX].oneOf.0.call_duration_seconds.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Call Duration Seconds","description":"Duration of the call in seconds","uniqueKey":"calls.items.[INDEX].oneOf.0.call_duration_seconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.0.call_duration_seconds","typeLabel":"integer | null"},"call_type":{"type":"string","const":"web_call","title":"Call Type","description":"Indicates this response is for a web-based call","default":"web_call","uniqueKey":"calls.items.[INDEX].oneOf.0.call_type","typeLabel":"string"},"call_finish_reason":{"oneOf":[{"type":"string","title":"Call Finish Reason","description":"Detailed reason why the web call ended, if applicable","enum":["user_ended_call","agent_ended_call","call_transferred","inactivity_timeout","maximum_duration_exceeded","concurrent_call_limit_reached","invalid_payment","potential_scam_detected","inbound_webhook_error","line_busy","call_failed","no_answer","llm_websocket_initialization_error","llm_websocket_connection_lost","llm_websocket_runtime_error","llm_websocket_payload_corruption","twilio_error","no_audio_input","speech_recognition_error","pia_platform_internal_error","unknown_error","user_connection_failure"],"uniqueKey":"calls.items.[INDEX].oneOf.0.call_finish_reason.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Call Finish Reason","description":"Detailed reason why the web call ended, if applicable","uniqueKey":"calls.items.[INDEX].oneOf.0.call_finish_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.0.call_finish_reason","typeLabel":"enum\u003cstring> | null"},"call_id":{"oneOf":[{"type":"string","title":"Call Id","description":"Call identifier (same value as `_id` for most calls)","uniqueKey":"calls.items.[INDEX].oneOf.0.call_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Call Id","description":"Call identifier (same value as `_id` for most calls)","uniqueKey":"calls.items.[INDEX].oneOf.0.call_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.0.call_id","typeLabel":"string | null"},"call_reference_id":{"oneOf":[{"type":"string","title":"Call Reference Id","description":"Reference ID in `a:b:c` format (three colon-separated segments). Omitted when not set.","x-unpublished-description":"Reference ID in `a:b:c` format (e.g. `campaign_id:recipient_id:attempt_no`) for campaign and batch calls. Omitted when not set.","uniqueKey":"calls.items.[INDEX].oneOf.0.call_reference_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Call Reference Id","description":"Reference ID in `a:b:c` format (three colon-separated segments). Omitted when not set.","x-unpublished-description":"Reference ID in `a:b:c` format (e.g. `campaign_id:recipient_id:attempt_no`) for campaign and batch calls. Omitted when not set.","uniqueKey":"calls.items.[INDEX].oneOf.0.call_reference_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.0.call_reference_id","typeLabel":"string | null"},"updated_date_time":{"oneOf":[{"type":"string","title":"Updated Date Time","description":"When the call record was last updated, in UTC","format":"date-time","uniqueKey":"calls.items.[INDEX].oneOf.0.updated_date_time.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Updated Date Time","description":"When the call record was last updated, in UTC","uniqueKey":"calls.items.[INDEX].oneOf.0.updated_date_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.0.updated_date_time","typeLabel":"string\u003cdate-time> | null"},"batch_id":{"oneOf":[{"type":"string","title":"Batch Id","description":"Batch call ID, if the call belongs to a batch. Omitted when not set.","uniqueKey":"calls.items.[INDEX].oneOf.0.batch_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Batch Id","description":"Batch call ID, if the call belongs to a batch. Omitted when not set.","uniqueKey":"calls.items.[INDEX].oneOf.0.batch_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.0.batch_id","typeLabel":"string | null"}},"uniqueKey":"calls.items.[INDEX].oneOf.0","typeLabel":"WebCallResponse · object"},{"type":"object","title":"PhoneCallResponse","required":["call_status","from_number","to_number","direction"],"x-unpublished-properties":{"_note":"Hidden until published. To publish, move these back into `properties`.","sip_header_attributes":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Sip Header Attributes","description":"SIP header attributes attached to the call. Omitted when not set."},"campaign_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id","description":"Campaign ID, if the call belongs to a campaign. Omitted when not set."}},"properties":{"call_status":{"type":"string","enum":["registered","ongoing","ended","error","unreachable"],"title":"Call Status","description":"Current status of the call: 'registered' for initialized calls, 'ongoing' for active calls, 'ended' for completed calls, 'error' for failed calls, 'unreachable' when the callee could not be reached","isRequired":true,"uniqueKey":"calls.items.[INDEX].oneOf.1.call_status","typeLabel":"enum\u003cstring>"},"from_number":{"type":"string","title":"From Number","description":"The phone number that initiated the call (E.164 format)","isRequired":true,"uniqueKey":"calls.items.[INDEX].oneOf.1.from_number","typeLabel":"string"},"to_number":{"type":"string","title":"To Number","description":"The phone number that received the call (E.164 format)","isRequired":true,"uniqueKey":"calls.items.[INDEX].oneOf.1.to_number","typeLabel":"string"},"direction":{"type":"string","enum":["inbound","outbound"],"title":"Direction","description":"Indicates whether the call was received by or initiated from the Pia Platform","isRequired":true,"uniqueKey":"calls.items.[INDEX].oneOf.1.direction","typeLabel":"enum\u003cstring>"},"_id":{"type":"string","title":"Id","description":"Unique identifier for the call","uniqueKey":"calls.items.[INDEX].oneOf.1._id","typeLabel":"string"},"ai_agent_id":{"oneOf":[{"type":"string","title":"Ai Agent Id","description":"Identifier of the AI agent handling this call","uniqueKey":"calls.items.[INDEX].oneOf.1.ai_agent_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Ai Agent Id","description":"Identifier of the AI agent handling this call","uniqueKey":"calls.items.[INDEX].oneOf.1.ai_agent_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.1.ai_agent_id","typeLabel":"string | null"},"ai_agent_name":{"oneOf":[{"type":"string","title":"Ai Agent Name","description":"Name of the AI agent handling this call","uniqueKey":"calls.items.[INDEX].oneOf.1.ai_agent_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Ai Agent Name","description":"Name of the AI agent handling this call","uniqueKey":"calls.items.[INDEX].oneOf.1.ai_agent_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.1.ai_agent_name","typeLabel":"string | null"},"override_ai_agent_id":{"oneOf":[{"type":"string","title":"Override Ai Agent Id","description":"Optional identifier for an alternative AI agent handling this call","uniqueKey":"calls.items.[INDEX].oneOf.1.override_ai_agent_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Override Ai Agent Id","description":"Optional identifier for an alternative AI agent handling this call","uniqueKey":"calls.items.[INDEX].oneOf.1.override_ai_agent_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.1.override_ai_agent_id","typeLabel":"string | null"},"metadata":{"oneOf":[{"type":"object","title":"Metadata","description":"Custom key-value pairs storing additional information about the call","additionalProperties":{"type":"string","uniqueKey":"calls.items.[INDEX].oneOf.1.metadata.oneOf.0.additionalProperties","typeLabel":"string"},"uniqueKey":"calls.items.[INDEX].oneOf.1.metadata.oneOf.0","typeLabel":"Metadata · object"},{"type":"null","title":"Metadata","description":"Custom key-value pairs storing additional information about the call","uniqueKey":"calls.items.[INDEX].oneOf.1.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.1.metadata","typeLabel":"Metadata · object | null"},"pia_llm_dynamic_data":{"oneOf":[{"type":"object","title":"Pia Llm Dynamic Data","description":"Dynamic data used by the AI agent during the call","uniqueKey":"calls.items.[INDEX].oneOf.1.pia_llm_dynamic_data.oneOf.0","typeLabel":"Pia Llm Dynamic Data · object"},{"type":"null","title":"Pia Llm Dynamic Data","description":"Dynamic data used by the AI agent during the call","uniqueKey":"calls.items.[INDEX].oneOf.1.pia_llm_dynamic_data.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.1.pia_llm_dynamic_data","typeLabel":"Pia Llm Dynamic Data · object | null"},"call_start_time":{"oneOf":[{"type":"string","title":"Call Start Time","description":"Timestamp when the call was initiated, in UTC","format":"date-time","uniqueKey":"calls.items.[INDEX].oneOf.1.call_start_time.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Call Start Time","description":"Timestamp when the call was initiated, in UTC","uniqueKey":"calls.items.[INDEX].oneOf.1.call_start_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.1.call_start_time","typeLabel":"string\u003cdate-time> | null"},"call_end_time":{"oneOf":[{"type":"string","title":"Call End Time","description":"Timestamp when the call was terminated, in UTC","format":"date-time","uniqueKey":"calls.items.[INDEX].oneOf.1.call_end_time.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Call End Time","description":"Timestamp when the call was terminated, in UTC","uniqueKey":"calls.items.[INDEX].oneOf.1.call_end_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.1.call_end_time","typeLabel":"string\u003cdate-time> | null"},"messages":{"oneOf":[{"type":"array","items":{"properties":{"role":{"type":"string","enum":["agent","user"],"title":"Role","description":"Identifies whether the message is from the AI agent ('agent') or the human user ('user')","isRequired":true,"uniqueKey":"calls.items.[INDEX].oneOf.1.messages.oneOf.0.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"content":{"type":"string","title":"Content","description":"The actual text content of the message exchanged during the conversation","isRequired":true,"uniqueKey":"calls.items.[INDEX].oneOf.1.messages.oneOf.0.items.[INDEX].content","typeLabel":"string"},"started_at":{"oneOf":[{"type":"string","title":"Started At","description":"When this message started, relative to the call or as a timestamp","uniqueKey":"calls.items.[INDEX].oneOf.1.messages.oneOf.0.items.[INDEX].started_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Started At","description":"When this message started, relative to the call or as a timestamp","uniqueKey":"calls.items.[INDEX].oneOf.1.messages.oneOf.0.items.[INDEX].started_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.1.messages.oneOf.0.items.[INDEX].started_at","typeLabel":"string | null"},"ended_at":{"oneOf":[{"type":"string","title":"Ended At","description":"When this message ended, relative to the call or as a timestamp","uniqueKey":"calls.items.[INDEX].oneOf.1.messages.oneOf.0.items.[INDEX].ended_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Ended At","description":"When this message ended, relative to the call or as a timestamp","uniqueKey":"calls.items.[INDEX].oneOf.1.messages.oneOf.0.items.[INDEX].ended_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.1.messages.oneOf.0.items.[INDEX].ended_at","typeLabel":"string | null"}},"type":"object","required":["role","content"],"title":"MessageItem","uniqueKey":"calls.items.[INDEX].oneOf.1.messages.oneOf.0.items.[INDEX]","typeLabel":"MessageItem · object"},"title":"Messages","description":"Chronological list of messages exchanged during the call","uniqueKey":"calls.items.[INDEX].oneOf.1.messages.oneOf.0","typeLabel":"MessageItem · object[]"},{"type":"null","title":"Messages","description":"Chronological list of messages exchanged during the call","uniqueKey":"calls.items.[INDEX].oneOf.1.messages.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.1.messages","typeLabel":"MessageItem · object[] | null"},"recorded_call_audio_url":{"oneOf":[{"type":"string","title":"Recorded Call Audio Url","description":"URL to access the recorded audio file of the call","uniqueKey":"calls.items.[INDEX].oneOf.1.recorded_call_audio_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Recorded Call Audio Url","description":"URL to access the recorded audio file of the call","uniqueKey":"calls.items.[INDEX].oneOf.1.recorded_call_audio_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.1.recorded_call_audio_url","typeLabel":"string | null"},"access_token":{"oneOf":[{"type":"string","title":"Access Token","description":"Security token for accessing call-related resources","uniqueKey":"calls.items.[INDEX].oneOf.1.access_token.oneOf.0","typeLabel":"string"},{"type":"null","title":"Access Token","description":"Security token for accessing call-related resources","uniqueKey":"calls.items.[INDEX].oneOf.1.access_token.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.1.access_token","typeLabel":"string | null"},"call_duration_seconds":{"oneOf":[{"type":"integer","title":"Call Duration Seconds","description":"Duration of the call in seconds","uniqueKey":"calls.items.[INDEX].oneOf.1.call_duration_seconds.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Call Duration Seconds","description":"Duration of the call in seconds","uniqueKey":"calls.items.[INDEX].oneOf.1.call_duration_seconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.1.call_duration_seconds","typeLabel":"integer | null"},"call_type":{"type":"string","const":"phone_call","title":"Call Type","description":"Indicates this response is for a telephone call","default":"phone_call","uniqueKey":"calls.items.[INDEX].oneOf.1.call_type","typeLabel":"string"},"call_finish_reason":{"oneOf":[{"type":"string","title":"Call Finish Reason","description":"Detailed reason why the phone call ended, if applicable","enum":["user_ended_call","agent_ended_call","call_transferred","voicemail_detected","inactivity_timeout","answering_machine_detected","maximum_duration_exceeded","concurrent_call_limit_reached","invalid_payment","potential_scam_detected","inbound_webhook_error","line_busy","call_failed","no_answer","llm_websocket_initialization_error","llm_websocket_connection_lost","llm_websocket_runtime_error","llm_websocket_payload_corruption","frontend_payload_corruption","twilio_service_error","no_audio_input","speech_recognition_error","verbex_service_error","unknown_error","user_connection_failure","registered_call_timed_out"],"uniqueKey":"calls.items.[INDEX].oneOf.1.call_finish_reason.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Call Finish Reason","description":"Detailed reason why the phone call ended, if applicable","uniqueKey":"calls.items.[INDEX].oneOf.1.call_finish_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.1.call_finish_reason","typeLabel":"enum\u003cstring> | null"},"call_id":{"oneOf":[{"type":"string","title":"Call Id","description":"Call identifier (same value as `_id` for most calls)","uniqueKey":"calls.items.[INDEX].oneOf.1.call_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Call Id","description":"Call identifier (same value as `_id` for most calls)","uniqueKey":"calls.items.[INDEX].oneOf.1.call_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.1.call_id","typeLabel":"string | null"},"call_reference_id":{"oneOf":[{"type":"string","title":"Call Reference Id","description":"Reference ID in `a:b:c` format (three colon-separated segments). Omitted when not set.","x-unpublished-description":"Reference ID in `a:b:c` format (e.g. `campaign_id:recipient_id:attempt_no`) for campaign and batch calls. Omitted when not set.","uniqueKey":"calls.items.[INDEX].oneOf.1.call_reference_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Call Reference Id","description":"Reference ID in `a:b:c` format (three colon-separated segments). Omitted when not set.","x-unpublished-description":"Reference ID in `a:b:c` format (e.g. `campaign_id:recipient_id:attempt_no`) for campaign and batch calls. Omitted when not set.","uniqueKey":"calls.items.[INDEX].oneOf.1.call_reference_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.1.call_reference_id","typeLabel":"string | null"},"updated_date_time":{"oneOf":[{"type":"string","title":"Updated Date Time","description":"When the call record was last updated, in UTC","format":"date-time","uniqueKey":"calls.items.[INDEX].oneOf.1.updated_date_time.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Updated Date Time","description":"When the call record was last updated, in UTC","uniqueKey":"calls.items.[INDEX].oneOf.1.updated_date_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.1.updated_date_time","typeLabel":"string\u003cdate-time> | null"},"batch_id":{"oneOf":[{"type":"string","title":"Batch Id","description":"Batch call ID, if the call belongs to a batch. Omitted when not set.","uniqueKey":"calls.items.[INDEX].oneOf.1.batch_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Batch Id","description":"Batch call ID, if the call belongs to a batch. Omitted when not set.","uniqueKey":"calls.items.[INDEX].oneOf.1.batch_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"calls.items.[INDEX].oneOf.1.batch_id","typeLabel":"string | null"}},"uniqueKey":"calls.items.[INDEX].oneOf.1","typeLabel":"PhoneCallResponse · object"}],"uniqueKey":"calls.items.[INDEX]","typeLabel":"WebCallResponse · object | PhoneCallResponse · object"},"type":"array","title":"Calls","description":"List of call records, can include both web and phone calls","isRequired":true,"uniqueKey":"calls","typeLabel":"(WebCallResponse · object | PhoneCallResponse · object)[]"},"next_page_token":{"oneOf":[{"type":"string","title":"Next Page Token","description":"Token for retrieving the next page of results in paginated responses","uniqueKey":"next_page_token.oneOf.0","typeLabel":"string"},{"type":"null","title":"Next Page Token","description":"Token for retrieving the next page of results in paginated responses","uniqueKey":"next_page_token.oneOf.1","typeLabel":"null"}],"uniqueKey":"next_page_token","typeLabel":"string | null"},"total_count":{"oneOf":[{"type":"integer","title":"Total Count","description":"Total number of calls matching the query criteria","uniqueKey":"total_count.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Total Count","description":"Total number of calls matching the query criteria","uniqueKey":"total_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"total_count","typeLabel":"integer | null"}},"type":"object","required":["calls"],"title":"CallList","uniqueKey":"","typeLabel":"CallList · object"},"examples":{"Example":{"title":"Example","value":{"calls":[{"call_status":"registered","_id":"\u003cstring>","ai_agent_id":"\u003cstring>","ai_agent_name":"\u003cstring>","override_ai_agent_id":"\u003cstring>","metadata":{},"pia_llm_dynamic_data":{},"call_start_time":"2023-11-07T05:31:56Z","call_end_time":"2023-11-07T05:31:56Z","messages":[{"role":"agent","content":"\u003cstring>","started_at":"\u003cstring>","ended_at":"\u003cstring>"}],"recorded_call_audio_url":"\u003cstring>","access_token":"\u003cstring>","call_duration_seconds":123,"call_type":"web_call","call_finish_reason":"user_ended_call","call_id":"\u003cstring>","call_reference_id":"\u003cstring>","updated_date_time":"2023-11-07T05:31:56Z","batch_id":"\u003cstring>"}],"next_page_token":"\u003cstring>","total_count":123}}},"exampleType":"generated"}},"exampleType":"generated"},"f2227d5b-af79-410d-801b-8f9298f7cd8c":{"description":"Bad Request - missing or invalid query parameters.","content":{"application/json":{"schema":{"properties":{"status":{"type":"string","title":"Status","description":"HTTP status code, as a string (e.g. `\"422\"`)","isRequired":true,"uniqueKey":"status","typeLabel":"string"},"message":{"type":"string","title":"Message","description":"Error code or title. Values returned by the call service:\n\n| HTTP | `message` |\n|---|---|\n| 400 | `INVALID_ARGUMENT`, `INVALID_REQUEST_BODY`, `INPUT_ERROR`, `VALIDATION_ERROR`, `TYPE_MISMATCH`, `Bad Request` |\n| 403 | `Access denied` (call recording), `Forbidden` (get call) |\n| 404 | `Not Found` |\n| 422 | `Validation Error` |\n| 429 | `TOO_MANY_CONCURRENT_REQUESTS` |\n| 500 | `Internal Server Error` |","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error_details":{"type":"string","title":"Error Details","description":"Human-readable explanation of the error. For 5xx errors this is an opaque message with a reference ID (`An unexpected error occurred, reference: \u003cuuid>`) to share with support.","uniqueKey":"error_details","typeLabel":"string"}},"type":"object","required":["status","message"],"title":"CallErrorResponse","example":{"status":"422","message":"Validation Error","error_details":"Phone number is not registered"},"uniqueKey":"","typeLabel":"CallErrorResponse · object"},"examples":{"page_size":{"title":"page_size","value":{"status":"400","message":"Bad Request","error_details":"Page size can not exceeds 100"}},"sort":{"title":"sort","value":{"status":"400","message":"Bad Request","error_details":"sort_direction must be 'asc' or 'desc'"}},"date":{"title":"date","value":{"status":"400","message":"Bad Request","error_details":"Text '2026-13-01' could not be parsed: Invalid value for MonthOfYear (valid values 1 - 12): 13"}},"missing":{"title":"missing","value":{"status":"400","message":"Bad Request","error_details":"Required query parameter 'page_size' is not present."}}},"exampleType":"examples"}},"exampleType":"examples"},"44e06bfe-f4fe-48d8-a650-26ef2e1a6183":{"description":"Unauthorized - missing or invalid API key (returned by the gateway).","content":{"application/json":{"schema":{"type":"object","title":"GatewayAuthErrorResponse","description":"Returned by the API gateway when the API key is missing or invalid (the request never reaches the service).","properties":{"error":{"type":"string","title":"Error","example":"Authentication","uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","title":"Message","example":"Authentication failed","uniqueKey":"message","typeLabel":"string"},"traceId":{"type":"string","title":"Trace Id","example":"e679120f-1d1c-41d2-947c-34e194d5a4a1","uniqueKey":"traceId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"GatewayAuthErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":"Authentication","message":"Authentication failed","traceId":"e679120f-1d1c-41d2-947c-34e194d5a4a1"}}},"exampleType":"generated"}},"exampleType":"generated"},"dc567585-c6bf-4a6c-96d0-85552d5bed02":{"description":"Internal Server Error. `error_details` carries a reference ID for support.","content":{"application/json":{"schema":{"properties":{"status":{"type":"string","title":"Status","description":"HTTP status code, as a string (e.g. `\"422\"`)","isRequired":true,"uniqueKey":"status","typeLabel":"string"},"message":{"type":"string","title":"Message","description":"Error code or title. Values returned by the call service:\n\n| HTTP | `message` |\n|---|---|\n| 400 | `INVALID_ARGUMENT`, `INVALID_REQUEST_BODY`, `INPUT_ERROR`, `VALIDATION_ERROR`, `TYPE_MISMATCH`, `Bad Request` |\n| 403 | `Access denied` (call recording), `Forbidden` (get call) |\n| 404 | `Not Found` |\n| 422 | `Validation Error` |\n| 429 | `TOO_MANY_CONCURRENT_REQUESTS` |\n| 500 | `Internal Server Error` |","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error_details":{"type":"string","title":"Error Details","description":"Human-readable explanation of the error. For 5xx errors this is an opaque message with a reference ID (`An unexpected error occurred, reference: \u003cuuid>`) to share with support.","uniqueKey":"error_details","typeLabel":"string"}},"type":"object","required":["status","message"],"title":"CallErrorResponse","example":{"status":"422","message":"Validation Error","error_details":"Phone number is not registered"},"uniqueKey":"","typeLabel":"CallErrorResponse · object"},"example":{"status":"500","message":"Internal Server Error","error_details":"An unexpected error occurred, reference: 3f2b9c1e-7a41-4d6b-9a0e-2c5d8f1b6e47"},"examples":{"Example":{"title":"Example","value":{"status":"500","message":"Internal Server Error","error_details":"An unexpected error occurred, reference: 3f2b9c1e-7a41-4d6b-9a0e-2c5d8f1b6e47"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{},"servers":{}},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"hishabsingaporepteltd","siteName":"Verbex Docs","title":"List Calls - Verbex Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-09T06:00:03.542Z","originalFileLocation":"api-reference/calls/list-calls.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieve a paginated list of calls with optional filtering and sorting. This endpoint allows querying call history with various filters including time ranges and specific AI agents. Results are paginated for efficient data retrieval.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Verbex Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List Calls - Verbex Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve a paginated list of calls with optional filtering and sorting. This endpoint allows querying call history with various filters including time ranges and specific AI agents. Results are paginated for efficient data retrieval.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Verbex Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.verbex.ai/api-reference/calls/list-calls\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://hishabsingaporepteltd.mintlify.site/_mintlify/api/og/v2?division=Calls\u0026amp;title=List+Calls\u0026amp;description=Retrieve+a+paginated+list+of+calls+with+optional+filtering+and+sorting.%0A%0AThis+endpoint+allows+querying+call+history+with+various+filters+including+time+ranges%0Aa\u0026amp;theme=a7772b15e40ff7bbde18373a\u0026amp;signature=72d561310db26533e066d09d295db49d40cfdd79347438906a20a7cc56a11c54\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List Calls - Verbex Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve a paginated list of calls with optional filtering and sorting. This endpoint allows querying call history with various filters including time ranges and specific AI agents. Results are paginated for efficient data retrieval.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://hishabsingaporepteltd.mintlify.site/_mintlify/api/og/v2?division=Calls\u0026amp;title=List+Calls\u0026amp;description=Retrieve+a+paginated+list+of+calls+with+optional+filtering+and+sorting.%0A%0AThis+endpoint+allows+querying+call+history+with+various+filters+including+time+ranges%0Aa\u0026amp;theme=a7772b15e40ff7bbde18373a\u0026amp;signature=72d561310db26533e066d09d295db49d40cfdd79347438906a20a7cc56a11c54\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/hishabsingaporepteltd/72gxkt7gRN01IC5L/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Verbex Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.verbex.ai/api-reference/calls/list-calls\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/calls/list-calls.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.verbex.ai/#organization\",\"name\":\"Verbex Docs\",\"url\":\"https://docs.verbex.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/hishabsingaporepteltd/hKDJJlbuwj-_7GRI/light.png?fit=max\u0026auto=format\u0026n=hKDJJlbuwj-_7GRI\u0026q=85\u0026s=8e51283f8c4e5daa2b06e4c7b010036a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.verbex.ai#website\",\"name\":\"Verbex Docs\",\"url\":\"https://docs.verbex.ai\",\"publisher\":{\"@id\":\"https://docs.verbex.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.verbex.ai/api-reference/calls/list-calls#webpage\",\"url\":\"https://docs.verbex.ai/api-reference/calls/list-calls\",\"name\":\"List Calls\",\"description\":\"Retrieve a paginated list of calls with optional filtering and sorting. This endpoint allows querying call history with various filters including time ranges and specific AI agents. Results are paginated for efficient data retrieval.\",\"dateModified\":\"2026-11-09T06:00:03.542Z\",\"isPartOf\":{\"@id\":\"https://docs.verbex.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.verbex.ai/api-reference/calls/list-calls#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.verbex.ai/api-reference/calls/list-calls#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Calls\",\"item\":\"https://docs.verbex.ai/api-reference/calls/create-web-call\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List Calls\",\"item\":\"https://docs.verbex.ai/api-reference/calls/list-calls\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.verbex.ai/api-reference/calls/list-calls#apireference\",\"headline\":\"List Calls\",\"name\":\"List Calls\",\"description\":\"Retrieve a paginated list of calls with optional filtering and sorting. This endpoint allows querying call history with various filters including time ranges and specific AI agents. Results are paginated for efficient data retrieval.\",\"url\":\"https://docs.verbex.ai/api-reference/calls/list-calls\",\"mainEntityOfPage\":{\"@id\":\"https://docs.verbex.ai/api-reference/calls/list-calls#webpage\"},\"dateModified\":\"2026-11-09T06:00:03.542Z\",\"publisher\":{\"@id\":\"https://docs.verbex.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.verbex.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Verbex Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Verbex Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"Getting an API Key","href":"/api-reference/introduction"},{"title":"Migrate from v2 to v3","href":"/api-reference/ai-agents-v3/migrate-from-v2"}]},{"group":"AI Agents v3","pages":[{"title":"List AI Agents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v3/ai-agents","href":"/api-reference/ai-agents-v3/list-ai-agents"},{"title":"Create AI Agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v3/ai-agents","href":"/api-reference/ai-agents-v3/create-ai-agent"},{"title":"Get AI Agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v3/ai-agents/{agent_id}","href":"/api-reference/ai-agents-v3/get-ai-agent"},{"title":"Update AI Agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v3/ai-agents/{agent_id}","href":"/api-reference/ai-agents-v3/update-ai-agent"},{"title":"Delete AI Agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v3/ai-agents/{agent_id}","href":"/api-reference/ai-agents-v3/delete-ai-agent"}]},{"group":"AI Agents v2","pages":[{"title":"List AI Agents","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json get /v2/ai-agents/","href":"/api-reference/ai-agents-v2/list-ai-agents"},{"title":"Create AI Agent","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json post /v2/ai-agents/","href":"/api-reference/ai-agents-v2/create-ai-agent"},{"title":"Get AI Agent","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json get /v2/ai-agents/{agent_id}","href":"/api-reference/ai-agents-v2/get-ai-agent"},{"title":"Update AI Agent","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json put /v2/ai-agents/{agent_id}","href":"/api-reference/ai-agents-v2/update-ai-agent"},{"title":"Delete AI Agent","deprecated":true,"version":null,"openapi":"/api-reference/openapi.json delete /v2/ai-agents/{agent_id}","href":"/api-reference/ai-agents-v2/delete-ai-agent"}]},{"group":"LLM Models","pages":[{"title":"List LLM models","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/llm-models","href":"/api-reference/llm-models/list-llm-models"},{"title":"Get LLM model","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/llm-models/{llm_model_id}","href":"/api-reference/llm-models/get-llm-model"}]},{"group":"Speech Providers","pages":[{"title":"List STT providers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v3/stt/providers","href":"/api-reference/speech-providers/list-stt-providers"},{"title":"Get STT provider","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v3/stt/providers/{provider_name}","href":"/api-reference/speech-providers/get-stt-provider"},{"title":"List TTS providers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v3/tts/providers","href":"/api-reference/speech-providers/list-tts-providers"},{"title":"Get TTS provider","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v3/tts/providers/{provider_name}","href":"/api-reference/speech-providers/get-tts-provider"}]},{"group":"Built-in Tools","pages":[{"title":"List built-in tools","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/ai-agents/{ai_agent_id}/builtin-tools/","href":"/api-reference/built-in-tools/list-built-in-tools"},{"title":"Create built-in tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v2/ai-agents/{ai_agent_id}/builtin-tools/","href":"/api-reference/built-in-tools/create-built-in-tool"},{"title":"Get built-in tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/ai-agents/{ai_agent_id}/builtin-tools/{tool_id}","href":"/api-reference/built-in-tools/get-built-in-tool"},{"title":"Update built-in tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v2/ai-agents/{ai_agent_id}/builtin-tools/{tool_id}","href":"/api-reference/built-in-tools/update-built-in-tool"},{"title":"Delete built-in tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v2/ai-agents/{ai_agent_id}/builtin-tools/{tool_id}","href":"/api-reference/built-in-tools/delete-built-in-tool"}]},{"group":"Custom Tools","pages":[{"title":"List custom tools","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/ai-agents/{ai_agent_id}/custom-tools/","href":"/api-reference/custom-tools/list-custom-tools"},{"title":"Create custom tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v2/ai-agents/{ai_agent_id}/custom-tools/","href":"/api-reference/custom-tools/create-custom-tool"},{"title":"Get custom tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/ai-agents/{ai_agent_id}/custom-tools/{tool_id}","href":"/api-reference/custom-tools/get-custom-tool"},{"title":"Update custom tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v2/ai-agents/{ai_agent_id}/custom-tools/{tool_id}","href":"/api-reference/custom-tools/update-custom-tool"},{"title":"Delete custom tool","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v2/ai-agents/{ai_agent_id}/custom-tools/{tool_id}","href":"/api-reference/custom-tools/delete-custom-tool"}]},{"group":"Calls","pages":[{"title":"Create Web Call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/calls/create-web-call","href":"/api-reference/calls/create-web-call"},{"title":"Create Web Call (Public Shared)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/calls/public/create-web-call","href":"/api-reference/calls/create-web-call-public-shared"},{"title":"Dial Outbound Phone Call","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/calls/dial-outbound-phone-call","href":"/api-reference/calls/dial-outbound-phone-call"},{"title":"Get Call","description":"Retrieve detailed information about a specific call by its ID.\n\nThis endpoint provides comprehensive information about any call (web or phone) \nincluding its current status, duration, and associated metadata.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/calls/{call_id}","href":"/api-reference/calls/get-call"},{"title":"List Calls","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/calls/","href":"/api-reference/calls/list-calls"}]},{"group":"Call Recording","pages":[{"title":"Get Signed URL for Call Recording","description":"Get a pre-signed URL to access the recording of a specific call.\n\nThis endpoint generates a temporary signed URL that can be used to stream or download\nthe call recording. The signed URL expires after a limited time for security purposes.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/call-recording/signed-url","href":"/api-reference/call-recording/get-signed-url-for-call-recording"}]},{"group":"Post-call Analysis","pages":[{"title":"Get post-call analysis configuration for an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/ai-agents/{ai_agent_id}/postcall-analysis","href":"/api-reference/post-call-analysis/get-post-call-analysis-configuration-for-an-agent"},{"title":"Update an existing post-call analysis configuration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v2/ai-agents/{ai_agent_id}/postcall-analysis","href":"/api-reference/post-call-analysis/update-an-existing-post-call-analysis-configuration"},{"title":"Create a new post-call analysis configuration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v2/ai-agents/{ai_agent_id}/postcall-analysis","href":"/api-reference/post-call-analysis/create-a-new-post-call-analysis-configuration"},{"title":"Delete an existing post-call analysis configuration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v2/ai-agents/{ai_agent_id}/postcall-analysis","href":"/api-reference/post-call-analysis/delete-an-existing-post-call-analysis-configuration"},{"title":"Get Post Call Analysis Results","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/ai-agents/{ai_agent_id}/postcall-analysis/results/{call_id}","href":"/api-reference/post-call-analysis/get-post-call-analysis-results"}]},{"group":"Phone Numbers","pages":[{"title":"List phone numbers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/phone-numbers/","href":"/api-reference/phone-numbers/list-phone-numbers"},{"title":"Create a new phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/phone-numbers/","href":"/api-reference/phone-numbers/create-a-new-phone-number"},{"title":"Get a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/phone-numbers/{phone_number_id}","href":"/api-reference/phone-numbers/get-a-phone-number"},{"title":"Delete a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/phone-numbers/{phone_number_id}","href":"/api-reference/phone-numbers/delete-a-phone-number"},{"title":"Update a phone number","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /v1/phone-numbers/{phone_number_id}","href":"/api-reference/phone-numbers/update-a-phone-number"}]},{"group":"Knowledge Bases","pages":[{"title":"List Knowledge Bases","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-bases","href":"/api-reference/knowledge-bases/list-knowledge-bases"},{"title":"Create Knowledge Base","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge-bases","href":"/api-reference/knowledge-bases/create-knowledge-base"},{"title":"Get Knowledge Base","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-bases/{kb_id}","href":"/api-reference/knowledge-bases/get-knowledge-base"},{"title":"Delete Knowledge Base","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/knowledge-bases/{kb_id}","href":"/api-reference/knowledge-bases/delete-knowledge-base"},{"title":"Update Knowledge Base","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/knowledge-bases/{kb_id}","href":"/api-reference/knowledge-bases/update-knowledge-base"},{"title":"Upload a File","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge-bases/{kb_id}/documents/file","href":"/api-reference/knowledge-bases/upload-a-file"},{"title":"Discover a Website's URLs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-bases/documents/website/sitemaps","href":"/api-reference/knowledge-bases/discover-a-websites-urls"},{"title":"Crawl Web Pages","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge-bases/{kb_id}/documents/website","href":"/api-reference/knowledge-bases/crawl-web-pages"},{"title":"List Documents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-bases/{kb_id}/documents","href":"/api-reference/knowledge-bases/list-documents"},{"title":"Get Document Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-bases/{kb_id}/documents/{document_id}/status","href":"/api-reference/knowledge-bases/get-document-status"},{"title":"Inspect Indexed Chunks","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-bases/{kb_id}/documents/{document_id}/chunks","href":"/api-reference/knowledge-bases/inspect-indexed-chunks"},{"title":"Delete a Document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/knowledge-bases/{kb_id}/documents/{document_id}","href":"/api-reference/knowledge-bases/delete-a-document"},{"title":"Semantic Search","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/vector/search","href":"/api-reference/knowledge-bases/semantic-search"}]},{"group":"Public Sharing","pages":[{"title":"Create Share","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/public-sharing/","href":"/api-reference/public-sharing/create-share"},{"title":"Get Share","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/public-sharing/{ai_agent_id}","href":"/api-reference/public-sharing/get-share"},{"title":"Delete Share","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/public-sharing/{share_id}","href":"/api-reference/public-sharing/delete-share"}]},{"group":"Webhook Subscriptions","pages":[{"title":"Create a subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/public/webhook/subscription","href":"/api-reference/webhook-subscriptions/create-a-subscription"},{"title":"Get a subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/public/webhook/subscription/{id}","href":"/api-reference/webhook-subscriptions/get-a-subscription"},{"title":"Update a subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/public/webhook/subscription/{id}","href":"/api-reference/webhook-subscriptions/update-a-subscription"},{"title":"Delete a subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/public/webhook/subscription/{id}","href":"/api-reference/webhook-subscriptions/delete-a-subscription"},{"title":"Rotate the signing secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/public/webhook/subscription/{id}/rotate/secret","href":"/api-reference/webhook-subscriptions/rotate-the-signing-secret"},{"title":"List subscriptions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/public/webhook/subscriptions","href":"/api-reference/webhook-subscriptions/list-subscriptions"}]},{"group":"API Keys","pages":[{"title":"List API Keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/api-keys/","href":"/api-reference/api-keys/list-api-keys"},{"title":"Create API Key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/api-keys/","href":"/api-reference/api-keys/create-api-key"},{"title":"Get API Key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/api-keys/{key_id}","href":"/api-reference/api-keys/get-api-key"},{"title":"Revoke API Key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/api-keys/{key_id}/revoke","href":"/api-reference/api-keys/revoke-api-key"}]}]},{"tab":"Video Tutorials","pages":[{"title":"Video Tutorials","href":"/video-tutorials/introduction"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/changelog"}]}]},"basePath":"","title":"List Calls - Verbex Docs","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}