General API notes

All API calls (currently) permit only GET requests.

A trailing slash is optional on all API endpoints. There is no difference between using one and not using one.

Responses can be served as application/json or text/html as per the accept header. If the request is made in “text/html” then it will return the html content otherwise it will return the json content (unless JSONP is explicitly requested, in which case datagrepper returns the appropriate application/javascript).

/v2/id

Returns the message by the particular message-id given by the user.

Formatting arguments

chrome

Same as that of /v2/search

size

Same as that of /v2/search