# List messages in a conversation

**GET /v1/replicas/{replicaUUID}/conversations/{conversationUUID}/messages**

Retrieves messages in a specific conversation with cursor-based pagination. Messages are sorted chronologically from oldest to newest.

Use the `beforeUUID` parameter to get older messages and the `afterUUID` parameter to get newer messages. Please note:
 - When `beforeUUID` is specified, the most recent messages before `beforeUUID` are returned.
 - When `beforeUUID` and `afterUUID` are both specified, the most recent messages before `beforeUUID` are returned.
 - When `afterUUID` is specified on its own, the least recent messages after `afterUUID` are returned.


## Servers
- https://api.sensay.io: https://api.sensay.io ()


## Authentication methods
- Organization service token & User
- Organization service token


## Parameters
### Headers
- **X-API-Version** (string)


### Path parameters
- **replicaUUID** (string(uuid))
  The replica unique identifier (UUID)
- **conversationUUID** (string(uuid))
  The conversation UUID.

### Query parameters
- **limit** (number)
  The number of messages to fetch.
- **afterUUID** (string(uuid))
  Only show messages after given message UUID. Excludes given message UUID.
- **beforeUUID** (string(uuid))
  Only show messages before given message UUID. Excludes given message UUID.


## Responses
### 200
List of messages in the conversation

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **items** (array[object])


### 400
Bad Request

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **error** (string)
  A text representation of the error
- **error_code** (string)
  A machine-readable error code indicating the specific error condition. Used for programmatic error handling
- **fingerprint** (string)
  A unique identifier of the event, useful for reporting
- **request_id** (string)
  A unique identifier of the request, useful for reporting

### 401
Unauthorized

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **error** (string)
  A text representation of the error
- **error_code** (string)
  A machine-readable error code indicating the specific error condition. Used for programmatic error handling
- **fingerprint** (string)
  A unique identifier of the event, useful for reporting
- **request_id** (string)
  A unique identifier of the request, useful for reporting

### 404
Not Found

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **error** (string)
  A text representation of the error
- **error_code** (string)
  A machine-readable error code indicating the specific error condition. Used for programmatic error handling
- **fingerprint** (string)
  A unique identifier of the event, useful for reporting
- **request_id** (string)
  A unique identifier of the request, useful for reporting

### 415
Unsupported Media Type

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **error** (string)
  A text representation of the error
- **error_code** (string)
  A machine-readable error code indicating the specific error condition. Used for programmatic error handling
- **fingerprint** (string)
  A unique identifier of the event, useful for reporting
- **request_id** (string)
  A unique identifier of the request, useful for reporting

### 500
Internal Server Error

#### Body: application/json (object)
- **success** (boolean)
  Indicates the status of the request
- **error** (string)
  A text representation of the error
- **fingerprint** (string)
  A unique identifier of the event, useful for reporting
- **request_id** (string)
  A unique identifier of the request, useful for reporting
- **inner_exception** (object)
  The inner exception


[Powered by Bump.sh](https://bump.sh)