Get the status messages of a list of people
Programmatically retrieve the status messages of a specific list of people.You cannot request the status of more than 250 users. If you include the user IDs or email addresses of more than 250 people, the API truncates the input list to 250 values.
See Authenticating requests for information about how to authenticate the request.
Table 1. Atom API request details
Method Resource Output representation POST /atom/mv/theboard/all.do feed
Input
Standard 'application/x-www-form-urlencoded' HTTP form POST data. Identify the people whose status messages you want to return by specifying either their user ID or email address. The form fields correspond to the input data type. For example: userid={userid} or email={email}.
Output
A feed containing the status message for each person in the list. Because the feed was retrieved using a POST request instead of a GET request, the next links returned in the feed do not include information about the email addresses or user IDs used to filter the result. The caller of the API must resend the email or user ID list with each HTTP form-post request to get the results filtered as expected. As with the initial request, send the request to the URI specified in the next link using an HTTP POST.Returned HTTP headers
HTTP/1.1 204
Indicates that there was no content to return, which means that no status message was available.
HTTP/1.1 200 OK
Indicates that the status message was successfully found and returned. If an error occurs, this header contains one of the error codes.
Content-Type: application/atom+xml
Indicates that the document returned contains data in Atom format.
- HTTP/1.1 400 Bad Request
- HTTP/1.1 401 Unauthorized: Returned if you failed to authenticate the request.
- HTTP/1.1 404 Not Found
Parent topic
Getting Profiles feeds
});