Evo Voice

<back to all web services

ListNotifications

Lists all endpoints

Requires Authentication
Requires any of the roles:SystemAdministrator, Manager, Customer
The following routes are available for this service:
GET/notifications
ListNotifications Parameters:
NameParameterData TypeRequiredDescription
AccountIdsqueryList<string>NoThe IDs of the account whose notifications you want to retrieve
CustomerIdsqueryList<string>NoThe IDs of the customers whose notifications you want to retrieve
FromFilterquerystringNoFilter by From
ToFilterquerystringNoFilter by To
SubjectFilterquerystringNoFilter by Subject
StartDatequerystringNoThe start date to retrieve usage records for (YYYY-MM-DD)
EndDatequerystringNoThe end date to retrieve usage records for (YYYY-MM-DD)
TypequeryNotificationTypes?NoFilter by type
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
NotificationInfo Parameters:
NameParameterData TypeRequiredDescription
AccountIdformstringNoThe account ID this endpoint is associated with
AccountNameformstringNoThe name of the account this endpoint is associated with
CustomerIdformstringNoThe ID of the customer this endpoint is associated with
CustomerNameformstringNoThe name of the customer this endpoint is associated with
CustomerBreadcrumbformList<CustomerBreadcrumb>NoThe breadcrumb to the customer for this endpoint
TypeformNotificationTypesNoThe type of notification
SubjectformstringNoThe subject of the notification
BodyformstringNoThe body of the notification
RecipientsformList<NotificationRecipientInfo>NoThe recipients of this notification
AttachmentsformList<FileInfo>NoThe list of attachments
FromformstringNoThe original from for the session
ToformstringNoThe original To for the session
ErrorformboolNoWas there an error?
ErrorMessageformstringNoThe error message
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
CustomerBreadcrumb Parameters:
NameParameterData TypeRequiredDescription
IdformstringNo
NameformstringNo
NotificationTypes Enum:
Email
Sms
Push
IncomingCall
OutgoingCall
NotificationRecipientInfo Parameters:
NameParameterData TypeRequiredDescription
AddressformstringNoThe address of the recipient
ExtraformstringNoExtra info about the recipient e.g. CC, BCC
NameformstringNoThe name of the recipient
FileInfo Parameters:
NameParameterData TypeRequiredDescription
TypeformFileTypesNoThe type of file this is
AccountIdformstringNoThe account ID this file is associated with
AccountNameformstringNoThe name of the account this file is associated with
CustomerIdformstringNoThe ID of the customer this file is associated with
CustomerNameformstringNoThe name of the customer this file is associated with
CustomerBreadcrumbformList<CustomerBreadcrumb>NoThe breadcrumb to the customer for this file
UserIdformstringNoThe ID of the user this file is assocaited with
UserNameformstringNoThe name of the user this file is associated with
FileNameformstringNoThe original file name for the file
UriformstringNoThe URI of the file
ContentTypeformstringNoThe Content type of the file
ContentLengthformlongNoThe size of the file
RecordingSidformstringNoThe Twilio ID of the recording
RecordingDurationformintNoThe duration of the recording in seconds
RecordingFromformstringNoWho is the recording from?
TranscriptionformstringNoTranscription (if available)
FromAddressformstringNoFrom Address (e.g. caller ID) for incoming calls
ToAddressformstringNoTo Address (e.g. dialed number) for outgoing calls
FileTypes Enum:
Upload
VoiceMessage
CallRecording
Fax
Attachment
FaxOutgoing
ListResponse<AccountInfo> 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
BillingSettings Parameters:
NameParameterData TypeRequiredDescription
BaseformBillingItemNo
LocalNumbersformBillingItemNo
TollFreeNumbersformBillingItemNo
InboundVoiceCallsformBillingItemNo
OutboundVoiceCallsformBillingItemNo
InboundFaxesformBillingItemNo
OutboundFaxesformBillingItemNo
InboundSmsMessagesformBillingItemNo
OutboundSmsMessagesformBillingItemNo
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 /notifications HTTP/1.1 
Host: evovoice.io 
Accept: application/xml
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<ListResponseOfNotificationInfofvYQJmgX 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.Notifications">
    <d2p1:NotificationInfo>
      <CreatedBy>String</CreatedBy>
      <DateCreated>String</DateCreated>
      <DateLastModified>String</DateLastModified>
      <Id>String</Id>
      <LastModifiedBy>String</LastModifiedBy>
      <d2p1:AccountId>String</d2p1:AccountId>
      <d2p1:AccountName>String</d2p1:AccountName>
      <d2p1:Attachments xmlns:d4p1="http://schemas.datacontract.org/2004/07/Voice.Api.Files">
        <d4p1:FileInfo>
          <CreatedBy>String</CreatedBy>
          <DateCreated>String</DateCreated>
          <DateLastModified>String</DateLastModified>
          <Id>String</Id>
          <LastModifiedBy>String</LastModifiedBy>
          <d4p1:AccountId>String</d4p1:AccountId>
          <d4p1:AccountName>String</d4p1:AccountName>
          <d4p1:ContentLength>0</d4p1:ContentLength>
          <d4p1:ContentType>String</d4p1:ContentType>
          <d4p1:CustomerBreadcrumb xmlns:d6p1="http://schemas.datacontract.org/2004/07/Voice.Api.Customers">
            <d6p1:CustomerBreadcrumb>
              <d6p1:Id>String</d6p1:Id>
              <d6p1:Name>String</d6p1:Name>
            </d6p1:CustomerBreadcrumb>
          </d4p1:CustomerBreadcrumb>
          <d4p1:CustomerId>String</d4p1:CustomerId>
          <d4p1:CustomerName>String</d4p1:CustomerName>
          <d4p1:FileName>String</d4p1:FileName>
          <d4p1:FromAddress>String</d4p1:FromAddress>
          <d4p1:RecordingDuration>0</d4p1:RecordingDuration>
          <d4p1:RecordingFrom>String</d4p1:RecordingFrom>
          <d4p1:RecordingSid>String</d4p1:RecordingSid>
          <d4p1:ToAddress>String</d4p1:ToAddress>
          <d4p1:Transcription>String</d4p1:Transcription>
          <d4p1:Type>Upload</d4p1:Type>
          <d4p1:Uri>String</d4p1:Uri>
          <d4p1:UserId>String</d4p1:UserId>
          <d4p1:UserName>String</d4p1:UserName>
        </d4p1:FileInfo>
      </d2p1:Attachments>
      <d2p1:Body>String</d2p1:Body>
      <d2p1:CustomerBreadcrumb xmlns:d4p1="http://schemas.datacontract.org/2004/07/Voice.Api.Customers">
        <d4p1:CustomerBreadcrumb>
          <d4p1:Id>String</d4p1:Id>
          <d4p1:Name>String</d4p1:Name>
        </d4p1:CustomerBreadcrumb>
      </d2p1:CustomerBreadcrumb>
      <d2p1:CustomerId>String</d2p1:CustomerId>
      <d2p1:CustomerName>String</d2p1:CustomerName>
      <d2p1:Error>false</d2p1:Error>
      <d2p1:ErrorMessage>String</d2p1:ErrorMessage>
      <d2p1:From>String</d2p1:From>
      <d2p1:Recipients>
        <d2p1:NotificationRecipientInfo>
          <d2p1:Address>String</d2p1:Address>
          <d2p1:Extra>String</d2p1:Extra>
          <d2p1:Name>String</d2p1:Name>
        </d2p1:NotificationRecipientInfo>
      </d2p1:Recipients>
      <d2p1:Subject>String</d2p1:Subject>
      <d2p1:To>String</d2p1:To>
      <d2p1:Type>Email</d2p1:Type>
    </d2p1:NotificationInfo>
  </Items>
  <TotalCount>0</TotalCount>
  <TotalPages>0</TotalPages>
</ListResponseOfNotificationInfofvYQJmgX>