> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Introducción
> La API de validación bancaria de Cleariflow proporciona validación exhaustiva de números de cuenta bancaria internacional (IBAN) y códigos de identificación bancaria (BIC) a través de una interfaz JSON RESTful moderna, con soporte para más de 50 países e información detallada de validación y formato.
## Primeros pasos
El endpoint `iban` valida números de cuenta bancaria internacional (IBAN) con validación exhaustiva específica por país, comprobación de formato e información estructural detallada para aplicaciones financieras.
El endpoint `bic` valida códigos de identificación bancaria (BIC), proporcionando un desglose detallado de códigos bancarios, información del país y tipos de institución para operaciones bancarias internacionales.
Lista completa de países admitidos para la validación de IBAN y BIC, incluidos códigos de país, información de moneda y requisitos de formato específicos.
### Arquitectura REST
La API de validación bancaria sigue los principios REST, utilizando URL predecibles orientadas a recursos y códigos de estado HTTP estándar para una integración fluida y el manejo de errores.
### Seguridad HTTPS
Todas las comunicaciones de la API están protegidas mediante protocolos de cifrado TLS 1.2 o superior para garantizar la integridad y privacidad de los datos.
### Versionado de la API
La API de validación bancaria mantiene la compatibilidad hacia atrás mediante versionado y actualmente opera en la versión 1, con mejoras futuras planificadas.
### Autenticación
Su clave API sirve como credencial exclusiva para acceder a la API de validación bancaria. Cada servicio de Cleariflow requiere una clave única, lo que garantiza un acceso seguro y aislado entre las distintas APIs.
## Códigos de respuesta y error
Cuando las solicitudes fallan, la API devuelve respuestas de error JSON estructuradas con códigos y descripciones específicos para una resolución de problemas eficaz.
| Code | Type | Details |
| ---- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200 | OK | Todo funcionó como se esperaba. |
| 400 | Bad request | Solicitud incorrecta: parámetros faltantes o no válidos. |
| 401 | Unauthorized | La solicitud no fue aceptable. Normalmente debido a que la clave API falta o es incorrecta. |
| 422 | Quota reached | La solicitud se abortó por créditos API insuficientes. (Planes gratuitos) |
| 429 | Too many requests | La solicitud se abortó porque se alcanzó el número de solicitudes permitidas por segundo. Esto ocurre en planes gratuitos, ya que las solicitudes están limitadas a 1 por segundo. |
| 500 | Internal server error | La solicitud no pudo completarse debido a un error en el servidor. |
| 503 | Service unavailable | El servidor no estaba disponible. |