Skip to main content
GET
/
v1
/
links
List Links
curl --request GET \
  --url https://api.taap.it/v1/links \
  --header 'Authorization: <authorization>'
Retrieve all links with pagination and filtering options. Request:
cURL
curl -X GET 'https://api.taap.it/v1/links?archived=false&sort_by=created_at&sort_order=desc&page=1&page_size=20&cursor=eyJpZCI6ImxpbmtfOTg3NjU0MzIxIn0=' \
  -H 'Authorization: Bearer taapit_your_api_key_here'
Response: 
{
  "items": [
    {
      "id": "link_987654321",
      "original_url": "https://example.com/very-long-url-that-needs-shortening",
      "short_url": "https://taap.it/my-custom-link",
      "code": "my-custom-link",
      "created_at": "2024-01-15T10:30:00Z",
      "click_count": 42,
      "is_active": true,
      "is_archived": false
    }
  ],
  "page": 1,
  "page_size": 10,
  "has_next": true,
  "has_prev": false,
  "next_cursor": "eyJpZCI6ImxpbmtfOTg3NjU0MzIxIn0=",
  "prev_cursor": null
}

​
Authorization

​
Authorization
string
required
Bearer token for API authentication. Format: Bearer YOUR_API_KEY

​
Query Parameters

​
Pagination Parameters

​
cursor
string
Cursor for pagination (use for efficient pagination)
​
page
integer
default:"1"
Page number (starts from 1)
​
page_size
integer
default:"20"
Number of items per page (maximum 100)

​
Sorting Parameters

​
sort_by
string
Field to sort by (e.g., “created_at”, “updated_at”, “clicks”, “code”)
​
sort_order
string
default:"desc"
Sort order: “asc” for ascending or “desc” for descending

​
Filtering Parameters

​
archived
boolean
Filter by archived status (true for archived links, false for active links)