Skip to main content
GET
/
api
/
links
curl -X GET "https://api.linquid.io/api/links?page=1&limit=20&sortBy=createdAt&sortOrder=desc&archived=false" \
  -H "Authorization: Bearer <token>"
{
  "success": true,
  "data": [
    {
      "id": "link_abc123",
      "shortCode": "abc123",
      "shortUrl": "https://linqu.id/abc123",
      "title": "Launch Link",
      "destinationUrl": "https://example.com/launch",
      "campaignId": "campaign_123",
      "archived": false,
      "clicks": 104,
      "uniqueClicks": 91
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "sortBy": "createdAt",
    "sortOrder": "desc"
  }
}

Query Parameters

page
number
default:"1"
Page index
limit
number
default:"20"
Page size (1..100)
sortBy
string
default:"createdAt"
Sort field
sortOrder
string
default:"desc"
asc or desc
archived
boolean
default:"false"
true returns archived links only, false returns active links

Access

  • Permission: links:read
Behavior:
  • Response includes computed shortUrl.
  • Click/unique-click counters are populated from analytics stream when available.
curl -X GET "https://api.linquid.io/api/links?page=1&limit=20&sortBy=createdAt&sortOrder=desc&archived=false" \
  -H "Authorization: Bearer <token>"
{
  "success": true,
  "data": [
    {
      "id": "link_abc123",
      "shortCode": "abc123",
      "shortUrl": "https://linqu.id/abc123",
      "title": "Launch Link",
      "destinationUrl": "https://example.com/launch",
      "campaignId": "campaign_123",
      "archived": false,
      "clicks": 104,
      "uniqueClicks": 91
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "sortBy": "createdAt",
    "sortOrder": "desc"
  }
}