Get notification list

Method

GET

URL

https://typetalk.com/api/v1/notifications

Scope

my

Response Example

{
  "mentions": [
    {
      "id": 501,
      "readAt": null,
      "post": {
        "id": 309,
        "topicId": 203,
        "topic": {
          "id": 203,
          "name": "Techies",
          "description": "",
          "suggestion": "Techies",
          "isDirectMessage": false,
          "lastPostedAt": "2014-06-30T02:32:29Z",
          "createdAt": "2014-06-05T02:32:29Z",
          "updatedAt": "2014-06-05T02:32:29Z"
        },
        "replyTo": null,
        "message": "@jessica Help me!",
        "account": {
          "id": 102,
          "name": "moss",
          "fullName": "Moss",
          "suggestion": "Moss",
          "imageUrl": "https://typetalk.com/accounts/102/profile_image.png?t=1403749949000",
          "isBot": false,
          "createdAt": "2014-06-26T02:32:29Z",
          "updatedAt": "2014-06-26T02:32:29Z"
        },
        "attachments": [],
        "links": [],
        "directMessage": null,
        "createdAt": "2014-07-02T03:32:29Z",
        "updatedAt": "2014-07-02T03:32:29Z"
      }
    },
    {
      "id": 500,
      "readAt": "2014-06-30T15:00:00Z",
      "post": {
        "id": 308,
        "topicId": 202,
        "topic": {
          "id": 202,
          "name": "Arts & Crafts Club",
          "description": "",
          "suggestion": "Arts & Crafts Club",
          "isDirectMessage": false,
          "lastPostedAt": "2014-06-30T02:32:29Z",
          "createdAt": "2014-06-04T02:32:29Z",
          "updatedAt": "2014-06-04T02:32:29Z"
        },
        "replyTo": null,
        "message": "@jessica What do you think about this?",
        "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"
        },
        "attachments": [],
        "links": [],
        "directMessage": null,
        "createdAt": "2014-07-01T03:32:29Z",
        "updatedAt": "2014-07-01T03:32:29Z"
      }
    }
  ],
  "invites": {
    "teams": [],
    "topics": [
      {
        "id": 601,
        "topic": {
          "id": 210,
          "name": "Development",
          "description": "",
          "suggestion": "Development",
          "isDirectMessage": false,
          "lastPostedAt": "2014-07-01T02:32:29Z",
          "createdAt": "2014-06-10T02:32:29Z",
          "updatedAt": "2014-06-10T02:32:29Z"
        },
        "sender": {
          "id": 105,
          "name": "brad",
          "fullName": "BradMarshalls",
          "suggestion": "BradMarshalls",
          "imageUrl": "https://typetalk.com/accounts/105/profile_image.png?t=1404009149000",
          "isBot": false,
          "createdAt": "2014-06-29T02:32:29Z",
          "updatedAt": "2014-06-29T02:32:29Z"
        },
        "account": {
          "id": 100,
          "name": "jessica",
          "fullName": "Jessica Fitzherbert",
          "suggestion": "Jessica Fitzherbert",
          "imageUrl": "https://typetalk.com/accounts/100/profile_image.png?t=1403577149000",
          "isBot": false,
          "createdAt": "2014-06-24T02:32:29Z",
          "updatedAt": "2014-06-24T02:32:29Z"
        },
        "message": "It is a new project. Join us!",
        "createdAt": "2014-07-04T02:32:29Z",
        "updatedAt": "2014-07-04T02:32:29Z"
      },
      {
        "id": 600,
        "topic": {
          "id": 209,
          "name": "Web Site",
          "description": "",
          "suggestion": "Web Site",
          "isDirectMessage": false,
          "lastPostedAt": "2014-07-01T02:32:29Z",
          "createdAt": "2014-06-10T02:32:29Z",
          "updatedAt": "2014-06-10T02:32:29Z"
        },
        "sender": {
          "id": 106,
          "name": "chelseab",
          "fullName": "ChelseaB",
          "suggestion": "ChelseaB",
          "imageUrl": "https://typetalk.com/accounts/106/profile_image.png?t=1404095549000",
          "isBot": false,
          "createdAt": "2014-06-30T02:32:29Z",
          "updatedAt": "2014-06-30T02:32:29Z"
        },
        "account": {
          "id": 100,
          "name": "jessica",
          "fullName": "Jessica Fitzherbert",
          "suggestion": "Jessica Fitzherbert",
          "imageUrl": "https://typetalk.com/accounts/100/profile_image.png?t=1403577149000",
          "isBot": false,
          "createdAt": "2014-06-24T02:32:29Z",
          "updatedAt": "2014-06-24T02:32:29Z"
        },
        "message": "It is a new project. Join us!",
        "createdAt": "2014-07-03T02:32:29Z",
        "updatedAt": "2014-07-03T02:32:29Z"
      }
    ]
  }
}

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).