---
title: "GET Messages"
method: GET
path: "/messages"
---

# GET Messages

`GET /messages`

## Request

- Base URL: `https://www.humanity.com/api/v2`
- URL: `https://www.humanity.com/api/v2/messages`
- Auth: API key in query parameter `access_token`

/messages
Permission level: 5

## Query parameters

- `mode` string
- `limit` integer
- `offset` string
- `id` string

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `4055810` object
      - `id` integer
      - `conversation` integer
      - `sender` integer
      - `sent` integer
      - `deleted` integer
      - `subject` string
      - `message` string
      - `grouped` integer
      - `receivers` object
        - `schedules` unknown[]
          - unknown
        - `individuals` string[]
      - `read` integer
    - `4055811` object
      - `id` integer
      - `conversation` integer
      - `sender` integer
      - `sent` integer
      - `deleted` integer
      - `subject` string
      - `message` string
      - `grouped` integer
      - `receivers` object
        - `schedules` unknown[]
          - unknown
        - `individuals` string[]
      - `read` integer
  - `metadata` unknown[]
    - unknown
  - `token` string
  - `error` unknown

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `ffb87b44c733`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/messages/get.md)

---

[API](https://skmtc.dev/humanity-com/apis/humanity.md) - [All operations](https://skmtc.dev/humanity-com/apis/humanity/llms.txt) - [OpenAPI document](https://skmtc.dev/humanity-com/apis/humanity/revisions/ffb87b44c733?raw)
