---
title: "Get a list of shares"
method: GET
path: "/shares"
tags: ["Shares"]
---

# Get a list of shares

`GET /shares`

Get a list of shares that you would have access to view through the web interface. You can limit which results are returned by specifying specific types of shares you wish to view, finding things shared with a specific email address, as well as finding shares for specific folder names.


**Notes:**

- Authenticated user requires [share permission](/docs/account/04-users/00-introduction#managing-user-roles-and-permissions).
- To get share objects with type send, authenticated user's role must be admin or master.

## Query parameters

- `offset` integer
- `limit` integer
- `scope` 'all' | 'active' | 'currentUser'
- `sort` 'created' | '-created'
- `type` 'receive' | 'shared_folder' | 'send'
- `include` string
- `name` string
- `recipient` string
- `message` string
- `username` string
- `search` string

## Headers

- `ev-api-key` string, required
- `ev-access-token` string, required

## Response `200`

Successful operation

- ShareCollectionResponse — unresolved $ref

---

[API](https://skmtc.net/prismic/apis/exavault-api.md) · [All operations](https://skmtc.net/prismic/apis/exavault-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prismic/exavault-api/revisions/a1bd874b5960/schema)