Documentation

List links

GET/v1/linksLinks

The account's links, newest first, 50 per page. q matches the ending, the destination and the title.

Parameters

Parameter	Type	Required	Description
`q`	string	optional	Search text.
`before`	integer, null	optional	The `next_before` of the previous page.

Example request

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

Example response

{
  "links": [
    {
      "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
`links`	Link[]
`links[].id`	string	Stable id. Every link route accepts it, or the ending.
`links[].code`	string	The ending: the path after snip.link/.
`links[].short_url`	string	The short link, ready to share or print.
`links[].url`	string	Where the link goes now. Change it any time; printed codes follow.
`links[].title`	string, null	A name for the dashboard. Null when unset.
`links[].redirect`	integer	302 (default: every scan is counted) or 301 (browsers may cache the hop).
`links[].disabled`	boolean	A disabled link answers 404 until it is enabled again.
`links[].clicks`	integer	Every click and scan since the link was made.
`links[].qr_style`	QrStyle	How the link's QR code is drawn in the dashboard and at its image URLs.
`links[].qr_png_url`	string	The link's QR code as PNG (512 px). Free, no key.
`links[].qr_svg_url`	string	The same code as SVG, for print.
`links[].created_at`	string
`links[].updated_at`	string
`next_before`	integer, null	Pass as `before` to get the next page. Null on the last page.
`total`	integer	Links in the account, disabled ones included.
`max_links`	integer	The plan's link allowance.

Errors

Status	Meaning
401	The API key is missing, malformed or revoked.
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