# Retrieve messages

Endpoint: GET /v1/messages
Version: 1.0.1

## Header parameters:

  - `x-correlation-id` (string)

## Query parameters:

  - `lastId` (integer, required)
    The id of the last message previously fetched

  - `count` (integer, required)
    The number of messages to retrieve. (default is 10)

  - `messageType` (string)
    The message type to filter on

  - `schemaVersion` (string)
    The schema version to filter on

  - `channel` (string)
    The channel for the messages.

  - `entity` (string, required)
    The sender/recipient to filter on. Depends on the sent flag.

  - `sent` (boolean, required)
    Display sent messages

  - `fromTimestamp` (string, required)
    The earliest timestampe to filter on

  - `toTimestamp` (string, required)
    The latest timestamp to filter on

## Response 200 fields (application/json):

  - `id` (integer, required)
    The id assigned by the messaging service.

  - `from` (integer, required)
    The sender of the message.

  - `to` (integer, required)
    Who the message is to be delivered to.

  - `timestamp` (string, required)
    The UTC timestamp of when the message was received.

  - `messageType` (string, required)
    The message type contained in the payload.

  - `schemaVersion` (string, required)
    The schema version of the message type.

  - `payload` (string, required)
    The base64 encoded message payload.


## Response 401 fields

## Response 403 fields

## Response 429 fields

## Response 500 fields