---
title: "List links (newest first, cursor-paginated)"
method: GET
path: "/api/links"
---

# List links (newest first, cursor-paginated)

`GET /api/links`

## Request

- Base URL: `https://app.whooshly.co`
- URL: `https://app.whooshly.co/api/links`
- Auth: HTTP bearer

## Query parameters

- `cursor` string
- `limit` integer
- `archived` 'only' | 'all'
- `q` string
- `type` 'short' | 'qr' | 'vcard' | 'bio' | 'page'
- `tag` string
- `active` boolean
- `createdAfter` integer: Epoch milliseconds
- `createdBefore` integer: Epoch milliseconds

## Response `200`

Links

- object
  - `links` Link[]
    - `id` string
    - `title` string, nullable
    - `tags` string[]
    - `slug` string
    - `destination` string, uri: http(s) URL
    - `type` string
    - `active` boolean
    - `archivedAt` string, date-time, nullable
  - `nextCursor` string, nullable

## Other responses

- `401`: Unauthorized

---

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