---
title: "List registered-user links"
method: GET
path: "/api/v1/links"
tags: ["Links"]
---

# List registered-user links

`GET /api/v1/links`

## Request

- Base URL: `https://workers.miniurl.com`
- URL: `https://workers.miniurl.com/api/v1/links`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Query parameters

- `limit` integer
- `offset` integer
- `cursor` string
- `search` string
- `domain` string

## Response `200`

Links returned

- LinkListResponse
  - `success` boolean, required
  - `data` object, required
    - `links` LinkRecord[], required
      - `short_url` string, required
      - `alias` string, required
      - `full_url` string, required
      - `domain` string, required
      - `manage_code` string, nullable
      - `created_at` string, date-time, required
      - `expires_at` string, date-time, nullable
      - `has_password` boolean
      - `clicks` integer
      - `last_clicked_at` string, date-time, nullable
    - `pagination` object, required
      - `total` integer, required
      - `limit` integer, required
      - `offset` integer, required

## Other responses

- `401`: Missing, invalid, expired, or wrong bearer token for this endpoint
- `429`: Rate limit, token quota, or plan quota exceeded

---

[API](https://skmtc.dev/miniurl/apis/miniurl-agent-first-api.md) · [All operations](https://skmtc.dev/miniurl/apis/miniurl-agent-first-api/llms.txt) · [OpenAPI document](https://skmtc.dev/miniurl/apis/miniurl-agent-first-api/revisions/1d12196927db?raw)