/api/v6/urlshortener/domainsListar dominios disponibles
Dominios donde tu organización puede publicar enlaces, con el predeterminado primero.
Alcance y límites
API key con el servicio urlshortener habilitado
30 solicitudes por minuto
Lista los dominios activos donde tu organización puede publicar enlaces: los de la plataforma más los propios ya verificados, con el predeterminado primero y el resto en orden alfabético. Un dominio propio que todavía no está verificado no sirve para crear enlaces y no aparece, salvo que lo pidas con include=unverified (llega con verified: false). No hay un endpoint para registrar o verificar dominios propios.
Parámetros de consulta
includeunverified agrega tus dominios propios que todavía no están verificados, para verlos; no sirven para crear enlaces.unverifiedRespuestas
Dominios disponibles.
{
"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
}
}include trae un valor que no existe.
Credenciales inválidas o faltantes.
La API key no tiene habilitado el acortador (o está apagado para tu organización), la key no se puede usar desde la red de la petición, o la organización no está activa.
Se excedió el límite de solicitudes.
Errores posibles
Códigos que este endpoint puede devolver en error.code. El detalle completo está en el catálogo.
AUTH_REQUIREDNo se envió un token Bearer y cada llamada lo requiere.401AUTH_INVALID_KEYLa API key no se reconoce: formato equivocado, revocada o vencida.403AUTH_SERVICE_NOT_ALLOWEDLa key no tiene permitido el servicio detrás de este endpoint.403AUTH_IP_NOT_ALLOWEDLa key solo funciona desde ciertas redes y tu IP no está entre ellas.403ACCOUNT_NOT_ACTIVETu organización está suspendida o cerrada.400VALIDATION_INVALID_PARAMETERUn parámetro o un campo del cuerpo no es válido.429RATE_TPS_EXCEEDEDExcediste el cupo de tu organización para este endpoint.