# List Top-Level Messages

List only the top-level message threads in the user account identified by , optionally within the time range bounded by  and/or . Top-level messages are the starting point of each message thread (i.e.  == ), that is, messages that are not responses to other messages.

Endpoint: GET /message/notes/{userId}
Version: 1.0
Security: sessionToken

## Path parameters:

  - `userId` (string, required)
    Tidepool User ID

## Query parameters:

  - `starttime` (string)
    Start Time. Start date/time of the range for messages
    Example: "2017-02-06T02:37:46Z"

  - `endtime` (string)
    End Time. End date/time of the range for messages
    Example: "2017-02-06T02:37:46Z"

## Response 200 fields (application/json):

  - `messages` (array, required)

  - `messages.message` (object)

  - `messages.message.id` (string, required)
    Example: "60e64ddf98b2350011b0f37f"

  - `messages.message.guid` (string, required)
    UUID v4 as defined in [RFC 4122](https://www.ietf.org/rfc/rfc4122.txt).
    Example: "b9468a76-4afc-4c33-8d1d-1f08324d9160"

  - `messages.message.parentmessage` (string,null, required)
    Example: "60e64ddf98b2350011b0f37f"

  - `messages.message.userid` (string, required)
    String representation of a Tidepool User ID. Old style IDs are 10-digit strings consisting of only hexadeximcal digits. New style IDs are 36-digit [UUID v4](https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_4_(random))

  - `messages.message.groupid` (string, required)
    String representation of a Tidepool User ID. Old style IDs are 10-digit strings consisting of only hexadeximcal digits. New style IDs are 36-digit [UUID v4](https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_4_(random))

  - `messages.message.timestamp` (string, required)
    [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) / [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) timestamp _with_ timezone information
    Example: "2017-02-06T02:37:46Z"

  - `messages.message.createdtime` (string, required)
    [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) / [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) timestamp _with_ timezone information
    Example: "2017-02-06T02:37:46Z"

  - `messages.message.modifiedtime` (string)
    [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) / [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) timestamp _with_ timezone information
    Example: "2017-02-06T02:37:46Z"

  - `messages.message.messagetext` (string, required)
    Example: "I ate a taco with 10g of carbs"

  - `messages.message.user` (object)

  - `messages.message.user.fullName` (string, required)
    Example: "James Jellyfish"

## Response 401 fields (application/json):

  - `messages` (array)

## Response 403 fields (application/json):

  - `messages` (array)

## Response 404 fields (application/json):

  - `messages` (array)