Get direct messages

Method

GET

URL

https://typetalk.com/api/v1/messages/@:accountName

Scope

topic.read

URL parameters

Name Type Description
accountName String Account name

Query parameters

Name Type Description
count (Optional) Number default value: 20, maximum: 200
from (Optional) Number references Post ID
direction (Optional) String “backward” or “forward”

Response Example

{
  "topic": null,
  "directMessage": {
    "account": {
      "id": 101,
      "name": "ahorowitz",
      "fullName": "AHorowitz",
      "suggestion": "AHorowitz",
      "imageUrl": "https://typetalk.com/accounts/101/profile_image.png?t=1403663549000",
      "isBot": false,
      "createdAt": "2014-06-25T02:32:29Z",
      "updatedAt": "2014-06-25T02:32:29Z"
    },
    "status": {
      "presence": "away",
      "web": null,
      "mobile": null
    }
  },
  "bookmark": null,
  "posts": null,
  "hasNext": null
}

All responses are text formatted as JSON, and include ETag. If you call an API with If-None-Match header, the server returns a 304 status code when the data is not changed. The date and time format is ISO 8601 and timezone is UTC (eg. 2014-01-09T06:20:08Z).