---
name: "links_list"
area: "links"
title: "List short links"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/links_list"
mcp_server: "https://api.conecto.chat/mcp/links"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/links/links_list"
---

# List short links (`links_list`)

The business's short links, newest first, with their clicks.

This account's short links, newest first, with their clicks. query matches the code, title or address.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

To find a link's code, or compare clicks between links.

## Say this to your agent

> Which of our short links got the most clicks this month?

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `query` | string | no | Up to 200 characters. |  |  |
| `limit` | integer | no | 1 to 200. |  | `50` |
| `offset` | integer | no | At least 0. |  | `0` |

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `links_list` on the MCP server `https://api.conecto.chat/mcp/links` with these arguments:

```json
{
  "limit": 50
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/links_list \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": 50}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "links_list",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "links": [
      {
        "code": "summer-sale",
        "short_url": "https://cncto.co/summer-sale",
        "url": "https://halversoncycle.example/summer?utm_source=flyer",
        "title": "Flyer, June 2025",
        "paused": false,
        "blocked": false,
        "clicks": 0,
        "last_clicked_at": null,
        "created_at": "2026-10-14T08:00:00+00:00"
      },
      {
        "code": "autumn-sale",
        "short_url": "https://cncto.co/autumn-sale",
        "url": "https://halversoncycle.example/bikes/gravel?utm_source=flyer&utm_campaign=autumn-sale",
        "title": "Flyer, October",
        "paused": false,
        "blocked": false,
        "clicks": 0,
        "last_clicked_at": null,
        "created_at": "2026-10-14T08:00:00+00:00"
      }
    ],
    "total": 2
  }
}
```

`result`: The links, newest first, each with its code, short_url, url, title, state and clicks, and the total.

## Errors

This tool has no errors of its own.

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [qr_create](https://conecto.chat/tools/links/qr_create.md): A QR code for a link or any text, saved in the file store as a PNG or SVG with a download link. $0.01 a call.
- [links_shorten](https://conecto.chat/tools/links/links_shorten.md): A short link at cncto.co/<code> that sends people on and counts the clicks. $0.01 a call.
- [links_get](https://conecto.chat/tools/links/links_get.md): One short link: where it goes, its clicks and the last click. Free up to 1,000,000 reads a month.
- [links_update](https://conecto.chat/tools/links/links_update.md): Sends a short link somewhere else, retitles it, or pauses and resumes it. $0.01 a call.
- [links_delete](https://conecto.chat/tools/links/links_delete.md): Deletes a short link for good; its code never opens anything again. Free.