GET/api/v6/urlshortener/links/{domain}/{code}

Get a short link

One of your links by domain and code.

Scope and limits

Scope

API key with the urlshortener service enabled

Usage limit

60 requests per minute

Returns one short link you own. A link belonging to another account returns 404: its existence is not disclosed.

Path parameters

domain
stringrequired
Domain of the link.
code
stringrequired
Short code or alias (lowercase).

Responses

200

The link.

{
  "success": true,
  "data": {
    "id": 1024,
    "code": "a1b2c3d",
    "domain": "go.acme.co",
    "shortUrl": "https://go.acme.co/a1b2c3d",
    "longUrl": "https://example.com/landing?utm_source=sms",
    "alias": false,
    "active": true,
    "expiresAt": null,
    "createdAt": "2026-06-01T15:04:05Z",
    "clicks": 0,
    "uniqueClicks": 0,
    "lastClickAt": null
  },
  "meta": {
    "requestId": "8f0c0e2a4b1d4c8fae2b7a91e0c5d3f6",
    "timestamp": "2026-06-01T15:04:05+00:00",
    "responseTimeMs": 7.2
  }
}
401

Invalid or missing credentials.

404

No link with that domain and code.

429

Request limit exceeded.

Possible errors

Codes this endpoint can return in error.code. The full detail lives in the catalog.

See the full catalog
GET /api/v6/urlshortener/links/{domain}/{code}
curl -X GET 'https://developers.hablame.co/api/v6/urlshortener/links/go.acme.co/a1b2c3d' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer hk_YOUR_API_KEY'

Try-It

Run the request against the real API with your own API key.

The key is used only in your browser for this request. It is not stored nor sent anywhere else.

Parameters

Domain of the link.

Short code or alias (lowercase).

GET https://developers.hablame.co/api/v6/urlshortener/links/go.acme.co/a1b2c3d

Response

You have not sent a request yet.