---
title: "List share links"
method: GET
path: "/shares"
---

# List share links

`GET /shares`

## Request

- Base URL: `https://www.useanyfile.com/api/v1`
- URL: `https://www.useanyfile.com/api/v1/shares`
- Auth: HTTP bearer

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

A page of share links

- object
  - `data` ShareWithFile[], required
    - `id` string, required
    - `isActive` boolean, required
    - `expiresAt` string, date-time, nullable, required
    - `viewCount` integer, required
    - `downloadCount` integer, required
    - `createdAt` string, date-time, required
    - `publicUrl` string, uri, required
    - `file` object, required
      - `name` string, required
      - `contentType` string, required
      - `size` integer, required
  - `pagination` Pagination, required
    - `nextCursor` string, nullable, required

## Other responses

- `400`: Structured AnyFile API error
- `401`: Structured AnyFile API error
- `403`: Structured AnyFile API error
- `404`: Structured AnyFile API error
- `409`: Structured AnyFile API error
- `429`: Structured AnyFile API error

---

[API](https://skmtc.dev/useanyfile/apis/anyfile-rest-api.md) · [All operations](https://skmtc.dev/useanyfile/apis/anyfile-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useanyfile/apis/anyfile-rest-api/revisions/bad3e5a8e395?raw)