Get All Links

GEThttps://viso.li/api/link

Returns a paginated list of short links you own. Each item has the same shape as GET link: slug, hostname, alias, createdAt, and destination URL.

Filter by hostname and by an optional createdAt window so you can pull links created in a date range.

Send Authorization: Bearer sk_api_your_api_key on every request. See authentication.

Query parameters

All filters are optional. Omit the createdAt window to include every link you own (still paginated).

Field	Type	Description
`domain`	string	Hostname to filter on. Use `viso.li` for default-domain links, or a verified custom hostname.
`createdFrom`	string	ISO 8601 inclusive start of the createdAt window.
`createdTo`	string	ISO 8601 inclusive end of the createdAt window. Must be on or after `createdFrom`.
`page`	number	Page number, starting at 1. Defaults to 1.
`pageSize`	number	Items per page, max 100. Defaults to 20.

This lists branded-domain links created between 1 January and 23 August 2026.

1curl "https://viso.li/api/link?domain=go.example.com&createdFrom=2026-01-01T00:00:00.000Z&createdTo=2026-08-23T23:59:59.000Z&page=1&pageSize=20" \

2 -H "Authorization: Bearer sk_api_your_api_key"

Returns 200 OK. Newest links first.

response.json

2 "links": [

3 {

4 "slug": "abc123",

5 "domain": "go.example.com",

6 "alias": "launch",

7 "createdAt": "2026-08-22T14:00:00.000Z",

8 "url": "https://example.com/bio"

9 }

10 ],

11 "page": 1,

12 "pageSize": 20,

13 "total": 1,

14 "totalPages": 1

15}

Response fields

Field	Type	Description
`links`	object[]	Page of links. Same fields as GET /api/link/:slug.
`page`	number	Current page.
`pageSize`	number	Requested page size.
`total`	number	Total matching links.
`totalPages`	number	Total pages at this page size.

Status	Error	Description
400	Bad Request	Invalid page, pageSize, or createdAt window.
401	Unauthorized	Missing, malformed, or invalid Bearer token.
429	Too Many Requests	More than 10 requests per minute or 50 requests per day.
500	Internal Server Error	Unexpected server error. Retry the request.