Viso.li

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

FieldTypeDescription
slugstringRequired. 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

FieldTypeDescription
slugstringRequired. Encoded short-link identifier.
domainstring | nullRequired. Hostname the link belongs to, or null for viso.li.
aliasstring | nullRequired. Custom back-half on a branded domain, if set.
createdAtstringRequired. ISO 8601 time the link was created.
expiredAtstring | nullRequired. ISO 8601 time the link stops redirecting, or null when it does not expire.
urlstringRequired. Destination URL.

Errors

StatusErrorDescription
401UnauthorizedMissing, malformed, or invalid Bearer token.
404Not FoundThe slug does not exist or does not belong to you.
429Too Many RequestsMore than 10 requests per minute and 50 requests per day. Some responses include a Retry-After header.
500Internal Server ErrorUnexpected server error. Retry the request.