Documentation

Get a link

GET/v1/links/{link}Links

One link by its id or ending, with its QR code URLs.

Parameters

Parameter	Type	Required	Description
`link`	string, in the path	required	The link's id, or its ending.

Example request

curl -s "https://snip.link/v1/links/spring-menu" \
  -H "Authorization: Bearer $SNIP_KEY"

Example response

{
  "link": {
    "id": "lnk_7f0c2a2b4bb04a8b",
    "code": "spring-menu",
    "short_url": "https://snip.link/spring-menu",
    "url": "https://example.com/menus/spring-2026",
    "title": "Spring menu",
    "redirect": 302,
    "disabled": false,
    "clicks": 1284,
    "qr_style": {
      "style": "rounded",
      "fg": "#111111",
      "bg": "#ffffff",
      "ecc": "M"
    },
    "qr_png_url": "https://snip.link/qr.png?data=https%3A%2F%2Fsnip.link%2Fspring-menu%3Fqr%3D1",
    "qr_svg_url": "https://snip.link/qr.svg?data=https%3A%2F%2Fsnip.link%2Fspring-menu%3Fqr%3D1",
    "created_at": "2026-10-01T09:12:40.000Z",
    "updated_at": "2026-10-18T16:03:11.000Z"
  }
}

Response fields

Field	Type	Description
`link`	Link
`link.id`	string	Stable id. Every link route accepts it, or the ending.
`link.code`	string	The ending: the path after snip.link/.
`link.short_url`	string	The short link, ready to share or print.
`link.url`	string	Where the link goes now. Change it any time; printed codes follow.
`link.title`	string, null	A name for the dashboard. Null when unset.
`link.redirect`	integer	302 (default: every scan is counted) or 301 (browsers may cache the hop).
`link.disabled`	boolean	A disabled link answers 404 until it is enabled again.
`link.clicks`	integer	Every click and scan since the link was made.
`link.qr_style`	QrStyle	How the link's QR code is drawn in the dashboard and at its image URLs.
`link.qr_png_url`	string	The link's QR code as PNG (512 px). Free, no key.
`link.qr_svg_url`	string	The same code as SVG, for print.
`link.created_at`	string
`link.updated_at`	string

Errors

Status	Meaning
401	The API key is missing, malformed or revoked.
404	No link by that id or ending in this account.
429	Either the key exceeded its requests-per-second limit (honor Retry-After), or a daily or plan quota is used up (`details.reason`).

Back to the guide