---
title: "Get List of Message Share Links of a Message"
method: GET
path: "/message-sharelinks/shared-links/{message_id}"
tags: ["Message Share Links"]
---

# Get List of Message Share Links of a Message

`GET /message-sharelinks/shared-links/{message_id}`

## Request

- Base URL: `https://api.carbonvoice.app`
- URL: `https://api.carbonvoice.app/message-sharelinks/shared-links/{message_id}`
- Auth: one of:
  - API key in header `pxtoken`
  - OAuth 2 (implicit, authorization URL `https://api.carbonvoice.app/oauth/authorize`)

## Path parameters

- `message_id` string, required

## Query parameters

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

## Response `200`

- GetMessageShareLinksBySharedMessageResponse
  - `filters` GetMessageShareLinksBySharedMessageFilter, required
    - `skip` number
    - `limit` number, nullable: Max number of results allowed per page is: **100**
    - `direction` 'older' | 'newer', nullable
  - `total_results` number, required
  - `results` MessageShareLink[], required
    - `_id` string, required: Unique Identifier of share link
    - `created_by` string, required: Identifier of the User who created the share/forward
    - `channel_id` string, nullable: Channel ID where forwarded message was sent to
    - `message_id` string, nullable: Message ID that has the share_link_id attached to
    - `created_at` number, required
    - `last_updated_at` number, required
    - `end_access_at` number, nullable: Date when the access to shared message ends
    - `revoked_at` number, nullable
    - `revoked_by` string, nullable
    - `share_type` 'forward' | 'link', required: What is the ShareType of the MessageShareLink
    - `access_type` 'public' | 'specified' | 'forward', required: What is the access type for the MessageShareLink
    - `specified_access` SpecifiedAccess[]: List of Specified Access for the MessageShareLink
      - `type` 'channel' | 'workspace' | 'workspace_group' | 'user', required: What is the Specified access type for the MessageShareLink
      - `ids` string[], required: List of IDs that have access to the MessageShareLink
    - `reply_type` 'shared' | 'private_only', required: How replies to this share link behave. Legacy links without the field are private_only.
    - `reply_conversation_id` string, nullable: Conversation holding the shared replies to this link, if one was already created

## 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)