Consultar el estado de un trabajo de fax

Consulte su trabajo

Use una cuenta MultiTEL API habilitada. Envíe credenciales HTTP Basic para una cuenta con contraseña, o un token Bearer para una cuenta con token. Los permisos de la cuenta y las restricciones de IP siguen aplicándose. No use credenciales internas de worker.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode job_id=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_status

job_id es obligatorio y debe ser el identificador hexadecimal de 32 caracteres devuelto por send_fax. Cópielo exactamente. Las solicitudes quedan acotadas al propietario autenticado.

Lea el resultado

Lea tanto el resultado HTTP como el JSON status.code. Los fallos JSON pueden llegar con HTTP 200. Una respuesta JSON exitosa tiene status y response; los ejemplos usan datos ficticios.

{
  "status": {
    "code": 200,
    "msg": "Fax status"
  },
  "response": {
    "job_id": "0123456789abcdef0123456789abcdef",
    "from_number": "+12125550123",
    "to_number": "+12125550124",
    "status": "queued",
    "result": "",
    "pages_requested": 3,
    "pages_sent": 0,
    "cost": "0.07500",
    "webhook_status": "",
    "created_at": "2026-10-23 10:00:00",
    "updated_at": "2026-10-23 10:00:00"
  }
}

El ejemplo es un trabajo en cola, no un fax entregado ni una cotización de precio. pages_requested es el recuento de páginas de origen detectado; pages_sent informa del progreso registrado por el procesamiento. cost es una cadena decimal y ya puede contener una estimación mientras está en cola. result contiene el detalle del procesamiento; webhook_status contiene el estado de callback registrado. Las marcas de tiempo son cadenas con formato de servidor sin un desfase de zona horaria.

Consulte con intervalos crecientes en lugar de un bucle apretado. El procesamiento puede informar un estado enviado o completado, pero la auditoría actual no ha establecido una garantía de entrega al destinatario. Para un documento crítico, confirme la recepción con el destinatario antes de tratarlo como entregado o de enviar un duplicado. El ciclo de vida del worker activo, las reglas de facturación finales y el contrato de callback siguen en verificación. No asuma que la aceptación en cola o un ID de trabajo no vacío equivalen a la entrega.

Errores

API código 400 significa job_id ausente o mal formado; 401 significa autenticación ausente; 404 significa que el trabajo no se encontró para esta cuenta. No infiera la titularidad solo a partir del identificador.