API de Suelomio

El mismo informe que ves en la web, por HTTP. Una clave de tu cuenta, un crédito por parcela, 60 peticiones por minuto. Solo en el plan Profesional.

Tu clave

Crea hasta 5 claves en Mis informes. Cada una se muestra una sola vez. Envíala en la cabecera Authorization.

Authorization: Bearer sm_live_…

Rutas

GET /api/v1/parcel?ref=

La criba gratuita de una parcela: identidad, cobertura y cuántas banderas. No gasta crédito.

POST /api/v1/report {"ref": "..."}

Abre el informe completo. La primera vez gasta un crédito y empieza la generación: responde 202 con ready_by mientras se construye (como mucho 24 h, casi siempre un minuto) y 200 con el informe cuando está. Una parcela abierta no vuelve a gastar.

GET /api/v1/report?ref=

Lee un informe que ya tienes. 202 si se está construyendo, 404 si no lo tienes.

GET /api/v1/report.pdf?ref=

El mismo informe en PDF.

GET /api/v1/account

Tu plan y tus créditos.

Respuestas

401

Sin clave o clave revocada.

403 plan_required

La cuenta no está en el plan Profesional.

402 credits_exhausted

No quedan créditos en el periodo. Compra créditos extra o espera a la renovación.

429

Más de 60 peticiones en un minuto. Retry-After dice cuánto esperar.

Ejemplo

curl -H "Authorization: Bearer $SUELOMIO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ref": "43044A00400099", "lang": "es"}' \
  https://suelomio.com/api/v1/report

Documento OpenAPI

Si usas un asistente de IA, el conector MCP conecta tu cuenta sin clave: suelomio.com/mcp