GET/api/v6/utilities/ping

Ping

Confirma que tu API key es válida y muestra lo que la API sabe de quien llama.

Alcance

Cualquier API key válida

Límite de uso

20 solicitudes por minuto

Devuelve el estado del llamante: confirma que la API key es válida y muestra los datos clave que la API conoce de quien llama.

Úsalo como prueba de humo después de configurar tus credenciales. Un 200 significa que tu integración está lista para llamar al resto de los endpoints.

Que la key es válida (pong: true).
La versión de la API que atendió el llamado.
La IP pública desde la que se origina el llamado.

El detalle de la organización, el centro de costo y los servicios habilitados no viaja en esta respuesta: vive en /api/v6/account/organization, /api/v6/account/cost-centers y /api/v6/catalog/services.

Respuestas

200

La key es válida.

{
  "success": true,
  "data": {
    "pong": true,
    "apiVersion": "v6",
    "client": { "ip": "203.0.113.45" }
  },
  "meta": {
    "requestId": "b9b1704baffab21150213c02fd853975",
    "timestamp": "2026-06-04T19:43:59+00:00",
    "responseTimeMs": 4.24
  }
}

401

Credenciales inválidas o faltantes. El error.code indica el motivo concreto.

403

Las credenciales son válidas, pero la organización no puede ejecutar la solicitud.

429

Se excedió el límite de solicitudes. Espera lo que indique Retry-After.

503

Servicio temporalmente no disponible. Reintenta después del tiempo indicado en Retry-After.

504

Se agotó el tiempo de espera al procesar la solicitud. Es seguro reintentar.

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.401AUTH_COST_CENTER_DISABLEDEl centro de costo asociado a la key está deshabilitado.403ACCOUNT_NOT_ACTIVETu organización está suspendida o cerrada.403ACCOUNT_BLOCKEDHay un bloqueo total activo: cada llamada se rechaza.403ACCOUNT_READ_ONLYModo solo lectura: solo pasan GET, HEAD y OPTIONS.403ACCOUNT_CONFIG_NOT_FOUNDNo pudimos cargar la organización de tu key.429RATE_DDOS_EXCEEDEDVolumen inusualmente alto desde tu IP de origen.429RATE_TPS_EXCEEDEDExcediste el cupo de tu organización para este endpoint.503INFRA_CACHE_UNAVAILABLEUn componente interno está temporalmente no disponible.503INFRA_DB_CONNECTION_ERRORUn servicio interno estuvo momentáneamente inalcanzable.504INFRA_DB_QUERY_TIMEOUTUna consulta interna tardó demasiado y se cortó.

Ver el catálogo completo

Alcance y límites

Respuestas

Errores posibles