---
title: "List Shares"
method: GET
path: "/v1/share/list/{conversation_id}"
tags: ["share"]
---

# List Shares

`GET /v1/share/list/{conversation_id}`

## Request

- Base URL: `https://api.evidenso.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.evidenso.com/v1/share/list/{conversation_id}`
- Auth: HTTP bearer

List all share links for a conversation.

- **conversation_id**: The conversation ID
- **include_inactive**: Include revoked shares (default: false)

Returns list of shares with access statistics.

## Path parameters

- `conversation_id` string, required

## Query parameters

- `include_inactive` boolean

## Response `200`

Successful Response

- ShareListResponse: Response for listing shares
  - `shares` ShareListItem[], required
    - `share_token` string, required
    - `share_type` string, required
    - `is_active` boolean, required
    - `expires_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
    - `access_count` integer, required
    - `last_accessed_at` string, date-time, nullable, required
    - `share_url` string, required
  - `total_count` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/evidenso/apis/persona-rag-api.md) - [All operations](https://skmtc.dev/evidenso/apis/persona-rag-api/llms.txt) - [OpenAPI document](https://skmtc.dev/evidenso/apis/persona-rag-api/revisions/86408c178d4f?raw)