# List the shares of one document.

`GET /api/plugins/docs/documents/{id}/shares`

Authentication: no security requirement declared for this operation.

Parameters:

- `id` (path, string, required)
  Type: string

Responses:

- 200: Shares retrieved successfully.

- 403: Not the creator and not a DOCS_MANAGE holder.

- 404: Document not found or not readable.

## Examples

### cURL

```bash
curl -X GET 'http://localhost:3000/api/plugins/docs/documents/string/shares'
```

### JavaScript

```javascript
const response = await fetch('http://localhost:3000/api/plugins/docs/documents/string/shares', {
  method: 'GET',
});

const data = await response.text();
```

### Python

```python
import requests

response = requests.get('http://localhost:3000/api/plugins/docs/documents/string/shares')
print(response.text)
```