| GET | /conversations |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| AccountIds | query | List<string> | No | The IDs of the account whose conversations you want to retrieve |
| EndpointIds | query | List<string> | No | The list of endpoint IDs whose conversations you want to retrieve |
| CustomerIds | query | List<string> | No | The list of customer IDs whose conversations you want to retrieve |
| AfterDate | query | string | No | The start date for the conversations you want to retrieve |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Conversations | form | List<ConversationInfo> | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Id | form | string | No | |
| EndpointId | form | string | No | |
| OtherAddress | form | string | No | |
| MostRecentMessage | form | MessageInfo | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Id | form | string | No | |
| AccountId | form | string | No | |
| CustomerId | form | string | No | |
| EndpointId | form | string | No | |
| EndpointDisplayName | form | string | No | |
| Date | form | string | No | |
| Direction | form | MessageDirections | No | |
| OtherAddress | form | string | No | |
| Sender | form | string | No | |
| Text | form | string | No | |
| IsUnread | form | bool | No |
| Incoming | |
| Outgoing |
To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
GET /conversations HTTP/1.1 Host: evovoice.io Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length
{
conversations:
[
{
id: String,
endpointId: String,
otherAddress: String,
mostRecentMessage:
{
id: String,
accountId: String,
customerId: String,
endpointId: String,
endpointDisplayName: String,
date: String,
direction: Incoming,
otherAddress: String,
sender: String,
text: String,
isUnread: False
}
}
]
}