Introducción

El API de Tasvalúo SAI revisa avalúos inmobiliarios de forma automática. Tu sistema le envía el PDF de un avalúo y el API:

Lee el documento y comprueba que sirve para evaluarse.
Lo evalúa contra la normativa en cinco etapas: documental, datos, cálculos, mercado y reglas.
Devuelve los hallazgos que encontró, cada uno con su severidad y una sugerencia.
Permite justificar cada hallazgo y, cuando no queda ninguno pendiente, emite un certificado firmado.
Da a un controlador las herramientas para verificar ese certificado y emitir el dictamen final.

Todo se hace con peticiones HTTPS y JSON, autenticadas con una API Key.

Empieza aquí

Tu primer avalúo de punta a punta con curl, en cinco llamadas.

Cómo conseguir una API Key, cómo enviarla y qué permisos pedir.

Los estados por los que pasa un avalúo y qué hacer en cada uno.

Cada endpoint con parámetros, ejemplos, respuesta y errores.


URL base	`API_URL`: `https://<HOST>`, el host que te entrega el equipo de Tasvalúo con tu llave
Autenticación	Cabecera `x-api-key` con tu llave `sai_live_…` o `sai_test_…`
Formato	JSON en UTF-8. Fechas en ISO 8601.
Identificador	Cada avalúo se consulta por su folio: `/v1/avaluos/{folio}`
Modelo	Asíncrono: crear un avalúo responde al instante y el resultado llega minutos después
Errores	Cuerpo JSON con `statusCode`, `message` y, en errores de negocio, un `code` estable

Con la URL base y la llave en API_URL y API_KEY (ver convenciones):

curl "$API_URL/v1/instituciones" \
  -H "x-api-key: $API_KEY"

Primeros pasos — la guía rápida, la autenticación y las convenciones comunes a todos los endpoints.
Guías — tareas completas explicadas paso a paso: crear un avalúo, seguir su avance, interpretar los resultados, justificar, certificar y dictaminar.
Catálogos — los valores válidos de instituciones, tipos de inmueble, reglas y secciones.
Referencia — la ficha de cada endpoint, los códigos de error y los valores de cada estado.