GET/api/v6/urlshortener/pricing

Precio vigente

Cuánto le cuesta a tu organización crear un enlace y cada visita, y si su plan lo incluye.

Alcance

API key con el servicio urlshortener habilitado

Límite de uso

60 solicitudes por minuto

Devuelve los precios que se le aplican hoy a tu organización: los generales del servicio o los propios que tenga pactados. Se cobra la creación de cada enlace y cada visita de una persona que llega al destino, también las repetidas. No se cobran las visitas de robots ni las vistas previas que arman las aplicaciones de mensajería (WhatsApp, Telegram, Facebook, Google Messages y similares) cuando alguien comparte el enlace.

Los importes van en micros: unidades de la moneda multiplicadas por 10⁶ (1000000 es 1,00). includedInPlan: true quiere decir que tu organización tiene hoy un plan mensual del acortador vigente: crear enlaces y las visitas van incluidos. Los precios llegan igual, para saber cuánto cubre el plan; si no hay tarifa configurada, llegan en null.

Respuestas

200

Precio vigente. Los importes del ejemplo son ilustrativos.

{
  "success": true,
  "data": {
    "currency": "COP",
    "perLinkMicro": 1000000,
    "perUniqueVisitMicro": 500000,
    "includedInPlan": false
  },
  "meta": {
    "requestId": "8f0c0e2a4b1d4c8fae2b7a91e0c5d3f6",
    "timestamp": "2026-09-23T18:30:00+00:00",
    "responseTimeMs": 7.2
  }
}

401

Credenciales inválidas o faltantes.

403

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.

429

Se excedió el límite de solicitudes.

409

El acortador no tiene precio para la moneda de tu organización, o tu organización todavía no tiene moneda. Pasa con plan o sin él, y en ese estado tampoco se pueden crear enlaces. No se arregla reintentando.

Errores posibles

Códigos que este endpoint puede devolver en error.code. El detalle completo está en el catálogo.

401AUTH_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.409URLSHORTENER_NOT_PRICEDEl acortador no tiene precio configurado para tu moneda.409URLSHORTENER_CURRENCY_UNDEFINEDTu organización todavía no tiene moneda definida.429RATE_TPS_EXCEEDEDExcediste el cupo de tu organización para este endpoint.

Ver el catálogo completo

Alcance y límites

Respuestas

Errores posibles