# Get a list of Call Summaries. **GET /v1/Voice/Summaries** Get a list of Call Summaries. ## Servers - https://insights.twilio.com: https://insights.twilio.com () ## Authentication methods - Account sid auth token ## Parameters ### Query parameters - **From** (string) A calling party. Could be an E.164 number, a SIP URI, or a Twilio Client registered name. - **To** (string) A called party. Could be an E.164 number, a SIP URI, or a Twilio Client registered name. - **FromCarrier** (string) An origination carrier. - **ToCarrier** (string) A destination carrier. - **FromCountryCode** (string) A source country code based on phone number in From. - **ToCountryCode** (string) A destination country code. Based on phone number in To. - **VerifiedCaller** (boolean) A boolean flag indicating whether or not the caller was verified using SHAKEN/STIR.One of 'true' or 'false'. - **HasTag** (boolean) A boolean flag indicating the presence of one or more [Voice Insights Call Tags](https://www.twilio.com/docs/voice/voice-insights/api/call/details-call-tags). - **StartTime** (string) A Start time of the calls. xm (x minutes), xh (x hours), xd (x days), 1w, 30m, 3d, 4w or datetime-ISO. Defaults to 4h. - **EndTime** (string) An End Time of the calls. xm (x minutes), xh (x hours), xd (x days), 1w, 30m, 3d, 4w or datetime-ISO. Defaults to 0m. - **CallType** (string) A Call Type of the calls. One of `carrier`, `sip`, `trunking` or `client`. - **CallState** (string) A Call State of the calls. One of `ringing`, `completed`, `busy`, `fail`, `noanswer`, `canceled`, `answered`, `undialed`. - **Direction** (string) A Direction of the calls. One of `outbound_api`, `outbound_dial`, `inbound`, `trunking_originating`, `trunking_terminating`. - **ProcessingState** (string) A Processing State of the Call Summaries. One of `completed`, `partial` or `all`. - **SortBy** (string) A Sort By criterion for the returned list of Call Summaries. One of `start_time` or `end_time`. - **Subaccount** (string) A unique SID identifier of a Subaccount. - **AbnormalSession** (boolean) A boolean flag indicating an abnormal session where the last SIP response was not 200 OK. - **AnsweredBy** (string | null) An Answered By value for the calls based on `Answering Machine Detection (AMD)`. One of `unknown`, `machine_start`, `machine_end_beep`, `machine_end_silence`, `machine_end_other`, `human` or `fax`. - **AnsweredByAnnotation** (string) Either machine or human. - **ConnectivityIssueAnnotation** (string) A Connectivity Issue with the calls. One of `no_connectivity_issue`, `invalid_number`, `caller_id`, `dropped_call`, or `number_reachability`. - **QualityIssueAnnotation** (string) A subjective Quality Issue with the calls. One of `no_quality_issue`, `low_volume`, `choppy_robotic`, `echo`, `dtmf`, `latency`, `owa`, `static_noise`. - **SpamAnnotation** (boolean) A boolean flag indicating spam calls. - **CallScoreAnnotation** (string) A Call Score of the calls. Use a range of 1-5 to indicate the call experience score, with the following mapping as a reference for the rated call [5: Excellent, 4: Good, 3 : Fair, 2 : Poor, 1: Bad]. - **BrandedEnabled** (boolean) A boolean flag indicating whether or not the calls were branded using Twilio Branded Calls. One of 'true' or 'false' - **VoiceIntegrityEnabled** (boolean) A boolean flag indicating whether or not the phone number had voice integrity enabled.One of 'true' or 'false' - **BrandedBundleSid** (string) A unique SID identifier of the Branded Call. - **BrandedLogo** (boolean) Indicates whether the branded logo was displayed during the in_brand branded call. Possible values are true (logo was present) or false (logo was not present). - **BrandedType** (string) Indicates whether the Branded Call is in_band vs out_of_band. - **BrandedUseCase** (string) Specifies the user-defined purpose for the call, as provided during the setup of in_band branded calling. - **BrandedCallReason** (string) Specifies the user-defined reason for the call, which will be displayed to the end user on their mobile device during an in_band branded call. - **VoiceIntegrityBundleSid** (string) A unique SID identifier of the Voice Integrity Profile. - **VoiceIntegrityUseCase** (string) A Voice Integrity Use Case . Is of type enum. One of 'abandoned_cart', 'appointment_reminders', 'appointment_scheduling', 'asset_management', 'automated_support', 'call_tracking', 'click_to_call', 'contact_tracing', 'contactless_delivery', 'customer_support', 'dating/social', 'delivery_notifications', 'distance_learning', 'emergency_notifications', 'employee_notifications', 'exam_proctoring', 'field_notifications', 'first_responder', 'fraud_alerts', 'group_messaging', 'identify_&_verification', 'intelligent_routing', 'lead_alerts', 'lead_distribution', 'lead_generation', 'lead_management', 'lead_nurturing', 'marketing_events', 'mass_alerts', 'meetings/collaboration', 'order_notifications', 'outbound_dialer', 'pharmacy', 'phone_system', 'purchase_confirmation', 'remote_appointments', 'rewards_program', 'self-service', 'service_alerts', 'shift_management', 'survey/research', 'telehealth', 'telemarketing', 'therapy_(individual+group)'. - **BusinessProfileIdentity** (string) A Business Identity of the calls. Is of type enum. One of 'direct_customer', 'isv_reseller_or_partner'. - **BusinessProfileIndustry** (string) A Business Industry of the calls. Is of type enum. One of 'automotive', 'agriculture', 'banking', 'consumer', 'construction', 'education', 'engineering', 'energy', 'oil_and_gas', 'fast_moving_consumer_goods', 'financial', 'fintech', 'food_and_beverage', 'government', 'healthcare', 'hospitality', 'insurance', 'legal', 'manufacturing', 'media', 'online', 'professional_services', 'raw_materials', 'real_estate', 'religion', 'retail', 'jewelry', 'technology', 'telecommunications', 'transportation', 'travel', 'electronics', 'not_for_profit' - **BusinessProfileBundleSid** (string) A unique SID identifier of the Business Profile. - **BusinessProfileType** (string) A Business Profile Type of the calls. Is of type enum. One of 'primary', 'secondary'. - **PageSize** (integer(int64)) How many resources to return in each list page. The default is 50, and the maximum is 1000. - **Page** (integer) The page index. This value is simply for client state. - **PageToken** (string) The page token. This is provided by the API. ## Responses ### 200 OK #### Headers - **Access-Control-Allow-Origin** (string) Specify the origin(s) allowed to access the resource - **Access-Control-Allow-Methods** (string) Specify the HTTP methods allowed when accessing the resource - **Access-Control-Allow-Headers** (string) Specify the headers allowed when accessing the resource - **Access-Control-Allow-Credentials** (boolean) Indicates whether the browser should include credentials - **Access-Control-Expose-Headers** (string) Headers exposed to the client #### Body: application/json (object) - **call_summaries** (array[object]) - **meta** (object) [Powered by Bump.sh](https://bump.sh)