Validate Ruc
Validate an issuer RUC against SRI catastro and return contributor data.
This endpoint is used during the onboarding company step to validate the RUC before saving the draft. It performs a live SRI lookup and autofills legalName and address when those fields are empty.
Requires an active onboarding session (validated via onboarding_ticket).
Returns ValidateRucResponse with:
- valid=true when RUC is found and contributor is active
- valid=false with error code when RUC is not found, inactive, or SRI is unavailable
Body
Response
Successful Response
Whether the RUC was found and is active
Lookup source
sri_cache, sri_live, not_found The validated RUC
Razón social from SRI
Nombre comercial from SRI
DirecciónCompleta from SRI
EstadoContribuyenteRuc from SRI
TipoContribuyente from SRI
Primer representante legal del contribuyente
Raw payload returned by SRI catastro
Error code if validation failed: not_found, inactive, sri_unavailable
Establecimientos asociados al RUC