Link
GEThttps://www.viso.li/api/link/:slug
Returns one short link you own: its slug, the hostname it belongs to, the optional alias, when it was created, and when it expires.
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://www.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 "expiredAt": "2026-12-31T23:59:59.000Z",
7 "url": "https://example.com/bio"
8}
Response fields
| Field | Type | Description |
|---|---|---|
slug | string | Required. Encoded short-link identifier. |
domain | string | null | Required. Hostname the link belongs to, or null for viso.li. |
alias | string | null | Required. Custom back-half on a branded domain, if set. |
createdAt | string | Required. ISO 8601 time the link was created. |
expiredAt | string | null | Required. ISO 8601 time the link stops redirecting, or null when it does not expire. |
url | string | Required. 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 and 50 requests per day. Some responses include a Retry-After header. |
| 500 | Internal Server Error | Unexpected server error. Retry the request. |