GET/api/v6/urlshortener/domains

List available domains

Domains your organization can publish links on, with the default first.

Scope and limits

Scope

API key with the urlshortener service enabled

Usage limit

30 requests per minute

Lists the active domains your organization can publish links on: platform domains plus your own already verified ones, with the default first and the rest in alphabetical order. An own domain that is not verified yet cannot be used to create links and does not appear, unless you ask for it with include=unverified (it comes with verified: false). There is no endpoint to register or verify your own domains.

Query parameters

include
stringoptional
unverified adds your own domains that are not verified yet, to see them; they cannot be used to create links.
unverified

Responses

200

Available domains.

{
  "success": true,
  "data": {
    "domains": [
      { "name": "h0b.co", "isDefault": true, "verified": true, "global": true, "usedByDefault": true }
    ]
  },
  "meta": {
    "requestId": "8f0c0e2a4b1d4c8fae2b7a91e0c5d3f6",
    "timestamp": "2026-09-23T18:30:00+00:00",
    "responseTimeMs": 7.2
  }
}
400

include carries a value that does not exist.

401

Invalid or missing credentials.

403

The API key does not have the URL shortener enabled (or it is turned off for your organization), the key cannot be used from the request network, or the organization is not active.

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/domains
curl -X GET 'https://developers.hablame.co/api/v6/urlshortener/domains' \
  -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

unverified adds your own domains that are not verified yet, to see them; they cannot be used to create links.

GET https://developers.hablame.co/api/v6/urlshortener/domains

Response

You have not sent a request yet.