Get Link

Returns the full details of a single link, including its current scan count and routing rules.

GET /v1/links/{link_id}

links:read

Path Parameters

Parameter	Type	Required	Description
`link_id`	`string` (UUID)	Yes	The unique identifier of the link.

Request Examples

curl https://xqr.co/api/v1/links/d47f2e1a-8c3b-4a5d-9e6f-1234567890ab \
  -H "Authorization: Bearer xqr_pk_a1b2c3d4.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

const linkId = "d47f2e1a-8c3b-4a5d-9e6f-1234567890ab";

const response = await fetch(`https://xqr.co/api/v1/links/${linkId}`, {
  headers: {
    Authorization: "Bearer xqr_pk_a1b2c3d4.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  },
});

const { data } = await response.json();
console.log(data.destination);

import httpx

link_id = "d47f2e1a-8c3b-4a5d-9e6f-1234567890ab"

response = httpx.get(
    f"https://xqr.co/api/v1/links/{link_id}",
    headers={
        "Authorization": "Bearer xqr_pk_a1b2c3d4.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    },
)

data = response.json()["data"]
print(data["destination"])

Response

200 OK

The link object.

{
  "data": {
    "id": "d47f2e1a-8c3b-4a5d-9e6f-1234567890ab",
    "short_url": "https://xqr.co/summer24",
    "short_code": "summer24",
    "destination": "https://example.com/summer-sale?utm_source=qr",
    "enabled": true,
    "labels": ["campaign", "summer"],
    "routing_rules": [],
    "scan_count": 1483,
    "last_scan_at": "2026-03-20T09:12:44Z",
    "expires_at": "2026-09-30T23:59:59Z",
    "created_at": "2026-03-01T10:00:00Z",
    "updated_at": "2026-03-15T08:22:11Z"
  },
  "meta": {
    "request_id": "req_2b3c4d5e6f708901",
    "rate_limit": {
      "limit": 600,
      "remaining": 597,
      "reset": 1742572800
    }
  }
}

Was this page helpful?