GET /content/notifications/v1/items

Notifications enable you to recognise what content has changed since a given date. The Content Items Notification contains information about changes to Content Items. The response includes a NotificationFeed, describing the feed; a list of Notifications, where each Notification resource represents an item of content that has been modified on or after the since date provided in the request; and a list of links, containing the url to use in retrieving the next set of results.

Request

HTTP Request

GET http://api.ft.com/content/notifications/v1/items

Parameters

Parameter NameValueDescription
since datetime The specified date since which the content items have been updated. This date cannot be earlier than 180 days before the current date. If the since parameter is not defined then it defaults to 15 minutes ago, so that content items changed in the last 15 minutes will be returned.
limit number The maximum number of notification entries required. Max value = 200. Min value = 1. If the parameter is not defined then it defaults to 200.

Request Body

Do not supply a request body with this method.

Response

HTTP Statuses

Http StatusDescription
200 OK A list of notifications can be provided for content that has been updated since the since date. This may be an empty list if no content has changed.
400 Bad Request The since date is optional but if supplied must be in the past and in the ISO format yyyy-mm-ddThh:mm:ss.ssZ. The limit is optional but if supplied must be between 1 and 200.

200 OK - A list of notifications can be provided for content that has been updated since the since date

If successful, this method returns a list of content Item Notifications resources and a notification feed

{
  “requestUrl”: string,
  “limit”: number,
  “notificationFeed”: {
  “id”: string,
  “apiUrl”: string
},
  “total”: number,
  “notifications”: [
    {
      “type”: string,
      “updated”: datetime,
      “data”: {
        “content-item”: {
          “id”: string,
          “apiUrl”: string
        }
      }
    }
  ]  ,
  “links”: [
    {
      “href”: string,
      “rel”: string
    }
  ]
}