---
title: "Get system message"
method: GET
path: "/lists/{listID}/messages/{messageID}"
tags: ["messages"]
---

# Get system message

`GET /lists/{listID}/messages/{messageID}`

## Request

- Base URL: `https://api.leadsforge.ai`
- URL: `https://api.leadsforge.ai/lists/{listID}/messages/{messageID}`
- Auth: API key in header `Authorization`

Get a system message by ID

## Path parameters

- `listID` string, required
- `messageID` string, required

## Response `200`

Message

- GetSystemMessageResponse
  - `displayOptions` DisplayOptions
    - `canReply` boolean
    - `leadsDisplayMode` 'none' | 'preview'
    - `progressState` 'none' | 'filtering' | 'searching' | 'completed' | 'failed'
    - `selectedPath` 'none' | 'icp' | 'company_lookalikes' | 'company_followers' | 'uploaded_contacts' | 'extension' | 'signals_funding' | 'signals_investors' | 'signals_job_change' | 'signals_acquisitions' | 'maps_discovery' | 'signals_hiring'
  - `message` MessageResponse
    - `actions` MessageActions
      - `options` MessageAction[]
        - `id` string
        - `text` string
        - `value` string
      - `selectionMode` 'single' | 'suggestion' | 'custom'
    - `created_at` string
    - `extraData` unknown
    - `id` string
    - `role` 'system' | 'user'
    - `status` 'pending' | 'ready'
    - `text` string

## Other responses

- `404`: Message Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/leadsforge/apis/leadsforge-api.md) - [All operations](https://skmtc.dev/leadsforge/apis/leadsforge-api/llms.txt) - [OpenAPI document](https://skmtc.dev/leadsforge/apis/leadsforge-api/revisions/b4a6596215b5?raw)