U2L AI
Links

List links

Returns your links, newest first by default, with pagination. Filter by type, domain, folder, tag, or free-text search across slug, destination, and title.

GET https://u2l.ai/api/v1/links

Authorizations

Authorizationstringrequired

Bearer authentication header of the form Bearer <token>, where <token> is your U2L API key (u2l_live_...). Create one in the dashboard under Settings > API.

Query Parameters

pageinteger

Page number (1-based). Defaults to 1.

limitinteger

Results per page (max 100). Defaults to 25.

typestring

Filter by link type. One of: SL, QR.

domainstring

Filter by domain.

folderIdstring

Filter by folder ID.

tagstring

Filter by tag.

searchstring

Free-text search across slug, destination, and title.

sortstring

Sort field. One of: createdAt, title, clicks. Defaults to "createdAt".

orderstring

Sort direction. One of: asc, desc. Defaults to "desc".

Response 200

linksobject[]
links[].idstring

Link ID (UUID).

links[].slugstring

The part after the domain.

links[].domainstring

The link's domain.

links[].destinationstring

Where the link redirects to.

links[].titlestring

Optional title.

links[].tagsstring[]
links[].hasPasswordboolean
links[].expiresAtstring

Expiration time, if set.

links[].permanentboolean

true = 301 redirect, false = 302.

links[].typestring

SL = short link, QR = QR code, PG = link-in-bio page. One of: SL, QR, PG.

links[].createdAtstring
links[].updatedAtstring
links[].folderIdstring
links[].clicksinteger

Total clicks.

links[].ogTitlestring

Custom social preview title.

links[].ogDescriptionstring
links[].ogImagestring
links[].abTestEnabledboolean
links[].destinationBstring

A/B variant destination.

links[].splitPercentageinteger

Traffic percentage to destination A.

links[].qrStyleobject

QR styling options (QR links only).

links[].externalBrowserboolean

Open in the phone's default browser when tapped inside in-app browsers (Android).

links[].cloakingboolean

URL cloaking (Advanced+): serve the destination inside a frame so visitors keep seeing the short URL.

links[].deepLinkboolean

Open the destination in its native mobile app (YouTube, Instagram, etc.) when the visitor has it installed.

links[].routingobject

Traffic routing rules (Advanced+). Matched visitors are redirected to the rule URL instead of the base destination; rules override the A/B pick.

links[].maxClicksinteger

Expire the link after this many human clicks (Growth+). Enforcement is eventual: the link stops within a few minutes of the limit; bot traffic never counts.

links[].expiredUrlstring

Where visitors are redirected (302) once the link has expired by date or click limit. Unset shows the standard expired page.

links[].startsAtstring

Before this time the link serves a not-active-yet page. Must be before expiresAt when both are set.

links[].clickCountinteger

Human clicks counted toward maxClicks. Present only when maxClicks is set.

links[].rotationobject

N-way weighted rotation (Advanced+). Visitors are split randomly across 2-10 target URLs by integer weights summing to 100. Supersedes the legacy abTest fields when set; analytics reports variants as A, B, C... by target order.

links[].pixelsobject[]

Retargeting pixels (Advanced+). Fired from a brief redirect page for human visitors only.

links[].appFallbackstring

App deep links (Advanced+): 'store' sends mobile visitors without the domain's app installed to the App Store / Play Store (with the link carried in the Play install referrer). Requires a mobile app configured on the link's domain in the dashboard; visitors with the app installed open it directly via the domain's universal/app links. One of: store.

paginationobject
pagination.pageinteger
pagination.limitinteger
pagination.totalinteger
pagination.totalPagesinteger
pagination.hasMoreboolean

Errors

401 Missing or invalid API key.
429 Rate limit exceeded. Check X-RateLimit-Reset for when the window resets.

See Rate Limits & Errors for the error envelope and per-plan limits. 

curl https://u2l.ai/api/v1/links \
  -H "Authorization: Bearer u2l_live_your_api_key"
const response = await fetch("https://u2l.ai/api/v1/links", {
  headers: {
    "Authorization": "Bearer u2l_live_your_api_key",
  },
});

const data = await response.json();
console.log(data);
import requests

response = requests.get(
    "https://u2l.ai/api/v1/links",
    headers={"Authorization": "Bearer u2l_live_your_api_key"},
)

print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://u2l.ai/api/v1/links", nil)
	req.Header.Set("Authorization", "Bearer u2l_live_your_api_key")
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}
{
  "links": [
    {
      "id": "9f0c2f9e-3b7a-4c1d-8e5f-2a6b7c8d9e0f",
      "slug": "my-link",
      "domain": "u.gy",
      "destination": "https://example.com/my-page",
      "title": "My example link",
      "tags": [
        "campaign"
      ],
      "hasPassword": false,
      "expiresAt": null,
      "permanent": true,
      "type": "SL",
      "createdAt": "2026-07-20T10:30:00.000Z",
      "updatedAt": "2026-07-20T10:30:00.000Z",
      "folderId": null,
      "clicks": 128
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total": 42,
    "totalPages": 2,
    "hasMore": true
  }
}