Links

Get a link

Fetches one link in the caller's workspace.

Auth: API key (Bearer flyn_sk_live_...), an MCP OAuth access token (Bearer flyn_mcp_at_...), or the signed-in dashboard session cookie when neither is sent.

Plan: every plan. Any team role.

Rate limit: 60 requests per 60 s per client IP, fixed window, in memory per server instance, checked before authentication.

get/api/links/{id}

Request

  • Base URL: https://www.flyn.to
  • URL: https://www.flyn.to/api/links/{id}
  • Auth: HTTP bearer

Response

The link.

idstring uuid required

Link id.

slugstring required

Back-half of the short URL.

urlstring required

Destination URL.

shortUrlstring uri required

Full short URL, https://<domain>/<slug>.

domainstring required

Short domain the link lives on. New links default to the current Flyn short domain.

titlestring nullable required

Display title.

clicksinteger required

Human clicks (bots and scanners excluded). This is the headline number.

botClicksinteger required

Clicks filtered out as bots or scanners.

qrScansinteger required

Clicks that arrived from a Flyn QR code; a subset of clicks.

totalClicksinteger required

clicks + botClicks.

status'active' | 'expired' | 'archived' required

Stored status. A link past expiresAt keeps active here; the redirect checks the expiry itself.

tagsstring[] required
createdAtstring date-time required
expiresAtstring nullable required

Expiry as stored (ISO 8601), or null.

folderIdstring uuid nullable required
passwordboolean required

True when the link is password protected. The password itself is never returned.

ogTitlestring nullable required
ogDescriptionstring nullable required
ogImagestring nullable required
cloakingboolean required
noIndexboolean required

Stored value of the legacy per-link no-index flag. It has no effect on how the link is served: every short link is already served with a noindex robots header on every plan, whether or not this is set.

notesstring nullable required

Private notes.

abUrlBstring nullable required

Legacy two-way A/B view of rotation, kept for older integrations.

abSplitnumber nullable required

Legacy A/B split: percent kept on the primary url.

deepLinkboolean required

Native-app handoff mode on mobile.

pixelIdsstring[] required

Retargeting pixels fired on click.

forwardParamsboolean required

Query-string passthrough to the destination.

clickLimitinteger nullable required

Maximum human clicks. Once reached, visitors go to fallbackUrl, or to the expired-link page when no http(s) fallbackUrl is set.

fallbackUrlstring nullable required

Destination after the click limit is reached.

conversionTrackingboolean required

When true, each human click gets a flyn_id click id for conversion pings.

conversionsinteger required

Recorded conversions, net of refunds (never below 0).

conversionValueCentsinteger required

Summed conversion value in minor units.

conversionCurrencystring nullable required

Currency of the summed value.

Changes

No recorded changes to this operation across all 1 revision of this API.