---
title: "Get List of forwards of a Message"
method: GET
path: "/message-forwards/forwarded-messages/{message_id}"
tags: ["Forwards"]
---

# Get List of forwards of a Message

`GET /message-forwards/forwarded-messages/{message_id}`

## Request

- Base URL: `https://api.carbonvoice.app`
- URL: `https://api.carbonvoice.app/message-forwards/forwarded-messages/{message_id}`
- Auth: `pxtoken` (a scheme the document does not define)

## Path parameters

- `message_id` string, required

## Query parameters

- `skip` number
- `limit` number, nullable
- `direction` 'older' | 'newer', nullable

## Response `200`

- GetForwardsByForwardedMessage
  - `filters` GetForwardsByForwardedMessageFilter, required
    - `skip` number
    - `limit` number, nullable: Max number of results allowed per page is: **100**
    - `direction` 'older' | 'newer', nullable
  - `total_results` number, required
  - `results` Forward[], required
    - `_id` string, required: Unique Identifier of forwarded/shared message
    - `forwarded_by` string, required: Identifier of the User who forwarded
    - `visibility` 'channel' | 'public', required: Which is the visibility of forwarded message (channel or public link)
    - `channel_id` string, nullable: Channel ID where forwarded/shared message was sent to
    - `message_id` string, nullable: Message ID that has the forward_id attached to
    - `created_at` number, required
    - `last_updated_at` number, required
    - `end_access_at` number, nullable: Date when the access to forwarded message ends
    - `revoked_at` number, nullable
    - `revoked_by` string, nullable

## Other responses

- `403`
- `404`

---

[API](https://skmtc.dev/carbonvoice/apis/carbon-voice-api.md) · [All operations](https://skmtc.dev/carbonvoice/apis/carbon-voice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/carbonvoice/apis/carbon-voice-api/revisions/b91c5c845122?raw)