---
title: "Retrieve messages"
method: GET
path: "/api/v1/messages/"
tags: ["messages"]
---

# Retrieve messages

`GET /api/v1/messages/`

Get messages between you and another user or your messages with all users.

## Query parameters

- `user_id` string
- `created_after` string
- `excluded_sender_ids` string
- `workspace_id` string
- `study_id` string

## Headers

- `Authorization` string, required

## Response `200`

Messages

- Messages
  - `results` Message[]
    - `id` string, required — Unique ID of the message
    - `sender_id` string, required — Id of the user who sent the message
    - `body` string, required — Body of the message.
    - `sent_at` string, date-time, required — Date time when message was sent
    - `type` string — Will only me message for now
    - `channel_id` string, required — The channel ID, for linking back to a thread in the Prolific app.
    - `data` MessageData — Metadata for a message
      - `study_id` string — What study the message relates to. In case this is not automatically filled for the participant, they can choose which study their message relates to.
      - `category` 'payment-timing' | 'payment-issues' | 'technical-issues' | 'feedback' | 'rejections' | 'other' — Participants can self-categorise their message before sending it.

## Other responses

- `400` — Error

---

[API](https://skmtc.net/prolific/apis/api-reference.md) · [All operations](https://skmtc.net/prolific/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prolific/api-reference/versions/dc6f073a9827/schema)