Get a Link
GEThttps://viso.li/api/link/:slug
Returns one short link you own: its slug, the hostname it belongs to, the optional alias, and when it was created.
domain is the hostname. It is null for viso.li links and a custom hostname such as go.example.com when the link is on a branded domain.
Send Authorization: Bearer sk_api_your_api_key on every request. See authentication.
Path parameters
| Field | Type | Description |
|---|---|---|
slug | string | Required. Public slug of the shortened link. |
Example request
1curl https://viso.li/api/link/abc123 \
2 -H "Authorization: Bearer sk_api_your_api_key"
Success response
Returns 200 OK.
response.json
1{
2 "slug": "abc123",
3 "domain": "go.example.com",
4 "alias": "launch",
5 "createdAt": "2026-08-22T14:00:00.000Z",
6 "url": "https://example.com/bio"
7}
Response fields
| Field | Type | Description |
|---|---|---|
slug | string | Encoded short-link identifier. |
domain | string | null | Hostname the link belongs to, or null for viso.li. |
alias | string | null | Custom back-half on a branded domain, if set. |
createdAt | string | ISO 8601 time the link was created. |
url | string | Destination URL. |
Errors
| Status | Error | Description |
|---|---|---|
| 401 | Unauthorized | Missing, malformed, or invalid Bearer token. |
| 404 | Not Found | The slug does not exist or does not belong to you. |
| 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. |