---
title: "List inbox messages"
method: GET
path: "/inboxmessage.json"
tags: ["Inbox"]
---

# List inbox messages

`GET /inboxmessage.json`

Retrieves a paginated list of inbox messages with optional filtering

## Query parameters

- `limit` integer
- `offset` integer
- `filter` 'all' | 'unread' | 'archived' | 'snoozed'
- `search` string

## Response `200`

Successful response

- InboxMessagesResponse
  - `messages` InboxMessage[]
    - `uuid` string, uuid
    - `active` boolean
    - `edit_date` string, date-time
    - `timestamp` string, date-time
    - `read_timestamp` string, date-time, nullable
    - `last_reply_timestamp` string, date-time, nullable
    - `snooze_until_timestamp` string, date-time, nullable
    - `read_by_staff_uuid` string, uuid, nullable
    - `from_name` string
    - `from_email` string
    - `to_email` string
    - `subject` string
    - `message_text` string
    - `message_html` string
    - `is_archived` boolean
    - `archived_timestamp` string, date-time, nullable
    - `archived_by_staff_uuid` string, uuid, nullable
    - `regarding_company_uuid` string, uuid, nullable
    - `converted_to_job_uuid` string, uuid, nullable
    - `job_template_uuid` string, uuid, nullable
    - `message_type` 'email' | 'sms' | 'online_booking' | 'phone_call' | 'reminder' | 'form' | 'network_request' | 'supplier_invoice' | 'asset' | 'partner_lead' | 'automation'
  - `pagination` object
    - `offset` integer
    - `limit` integer
    - `total` integer
    - `has_more` boolean

## Other responses

- `400` — Service Unavailable - Inbox not enabled
- `403` — Forbidden - Missing permission or OAuth scope

---

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