---
title: "List links"
method: GET
path: "/links"
tags: ["Link"]
---

# List links

`GET /links`

Retrieve a list of all short links with pagination.

## Query parameters

- `limit` integer
- `cursor` string
- `filter` LinkFilter
  - `id` string, uuid — Unique identifier of the link. Use this to update a specific link.
  - `urlContains` string — Filter links that contain this text in their URL.

## Response `200`

A page of links with pagination details.

- GetLinks200Response
  - `links` Link[], required
    - `url` string, uri, required — The URL of the link.
    - `hash` string, required — Unique hash, used as the short link.
    - `describe` string, required — Description of the link.
    - `created_at` string, date-time, required — Timestamp when the link was created.
    - `updated_at` string, date-time, required — Timestamp when the link was last updated.
  - `next_cursor` string, required — A cursor to be used to fetch the next page of results.

## Other responses

- `500` — Internal Server Error

---

[API](https://skmtc.dev/shortlink-org/apis/shortlink-link-bff.md) · [All operations](https://skmtc.dev/shortlink-org/apis/shortlink-link-bff/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/shortlink-org/shortlink-link-bff/revisions/a5800129f25f/schema)