Evo Voice

<back to all web services

ListAlerts

Retrieve alerts

Requires Authentication
Requires any of the roles:SystemAdministrator, Manager, Customer
The following routes are available for this service:
GET/alerts
ListAlerts Parameters:
NameParameterData TypeRequiredDescription
AccountIdsqueryList<string>NoFilter by accounts
NameFilterquerystringNoFilter by name
ListRequest<T> Parameters:
NameParameterData TypeRequiredDescription
PageformintNoThe page of data to retrieve
AllformboolNoIf you want all objects to be returned. This should be used with care
CountPerPageformintNoThe number per page to retrieve
SpecificIdsformList<string>NoSpecific IDs
SortFieldformstringNoSpecify a sort field
SortOrderformSortOrdersNoSpecify a sort order
SimplifiedPagingformboolNoDisables total / page counts - improves performance. Returns only data. If there is no more data, Items will be empty array
SortOrders Enum:
Ascend
Descend
AlertInfo Parameters:
NameParameterData TypeRequiredDescription
AccountIdformstringNoThe ID of the account associated with this alert
NameformstringNoThe name of the alert
TriggerformAlertTriggersNoThe trigger alert
WindowHoursformdoubleNoThe number of hours for the window over which the alert will trigger
ThresholdformdoubleNoThe value at which the alert will trigger
NotificationEmailAddressesformstringNoThe email addresses (one per line) to notify
CustomerSelectionformAlertCustomerSelectionNoCustomer selection for this alert
CustomerIdsformList<string>NoThe list of customer IDs for the selection model
EntityInfo Parameters:
NameParameterData TypeRequiredDescription
IdformstringNoThe ID of the object
DateCreatedformstringNoThe date the object was created
DateLastModifiedformstringNoThe date the object was last modified
CreatedByformstringNoThe user that created this object
LastModifiedByformstringNoThe user that last modified this object
AlertTriggers Enum:
CallSpend
CallCount
AlertCustomerSelection Enum:
AllCustomers
ExcludeCustomers
IncludeCustomers
ListResponse<T> Parameters:
NameParameterData TypeRequiredDescription
ItemsformList<AccountInfo>NoThe items
TotalCountformintNoThe total number of items
TotalPagesformintNoThe total number of pages
HasMorePagesformboolNoAre there more pages of items? Used with simplified paging
AccountInfo Parameters:
NameParameterData TypeRequiredDescription
NameformstringNoThe name of this account
ParentAccountIdformstringNoThe ID of this account's parent
TwilioAccountSidformstringNoThe twilio account SID
AncestorIdsformList<string>NoThe ancestors of this account. Useful for breadcrumbs
MaxPhoneNumbersformintNoThe max number of phone numbers this account can have
IsBYOAformboolNoThis account is BYOA
TrustHubProfileSidformstringNoTrustHub Profile Sid
LogoIdformstringNoThe ID of the logo file
LogoUriformstringNoThe URI of the logo file
BillingSettingsformBillingSettingsNoThe billing settings for this account
EnableInternationalSettingsformboolNoEnable international settings for the account?
DefaultInternationalCountryCodesformList<string>NoThe default list of country codes the account can dial when not specified on customer
BillingSettings Parameters:
NameParameterData TypeRequiredDescription
BaseformBillingItemNo
LocalNumbersformBillingItemNo
TollFreeNumbersformBillingItemNo
InboundVoiceCallsformBillingItemNo
OutboundVoiceCallsformBillingItemNo
InboundFaxesformBillingItemNo
OutboundFaxesformBillingItemNo
InboundSmsMessagesformBillingItemNo
OutboundSmsMessagesformBillingItemNo
AIInsightsformBillingItemNo
AILiveMinutesformBillingItemNo
AIMessagesformBillingItemNo
AITranscriptionsformBillingItemNo
BillingItem Parameters:
NameParameterData TypeRequiredDescription
BaseCostformdoubleNo
RawUnitMultiplierformdoubleNo
UnitCostformdoubleNo
AllowanceformintNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /alerts HTTP/1.1 
Host: evovoice.io 
Accept: application/xml
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<ListResponseOfAlertInfoLEzmHoIb xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Voice.Api">
  <HasMorePages>false</HasMorePages>
  <Items xmlns:d2p1="http://schemas.datacontract.org/2004/07/Voice.Api.Alerts">
    <d2p1:AlertInfo>
      <CreatedBy>String</CreatedBy>
      <DateCreated>String</DateCreated>
      <DateLastModified>String</DateLastModified>
      <Id>String</Id>
      <LastModifiedBy>String</LastModifiedBy>
      <d2p1:AccountId>String</d2p1:AccountId>
      <d2p1:CustomerIds xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:string>String</d4p1:string>
      </d2p1:CustomerIds>
      <d2p1:CustomerSelection>AllCustomers</d2p1:CustomerSelection>
      <d2p1:Name>String</d2p1:Name>
      <d2p1:NotificationEmailAddresses>String</d2p1:NotificationEmailAddresses>
      <d2p1:Threshold>0</d2p1:Threshold>
      <d2p1:Trigger>CallSpend</d2p1:Trigger>
      <d2p1:WindowHours>0</d2p1:WindowHours>
    </d2p1:AlertInfo>
  </Items>
  <TotalCount>0</TotalCount>
  <TotalPages>0</TotalPages>
</ListResponseOfAlertInfoLEzmHoIb>