Serveur MCP

Subastech — subastas judiciales de inmuebles (BOE)

com.subastech/subastas-judiciales

Ce que fait ce MCP

Searches and analyzes Spanish BOE judicial real-estate auctions, with property details, viability reports, alerts, market statistics, favorites, registral notes, and paid checkout.

alertas_activar
Activar o pausar una alerta
Activa o pausa una alerta tuya sin borrarla. Requiere cuenta verificada (scope `alertas:write`).
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id', 'activa'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la alerta (de `alertas_listar`).'}, 'activa': {'type': 'boolean', 'description': '`true` reanuda la alerta; `false` la pausa sin borrarla.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'activa': {'type': 'boolean'}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
alertas_crear
Crear una alerta
Crea una alerta de subastas (criterios, tipos de aviso, cadencia, canales). Requiere cuenta verificada (scope `alertas:write`). Envía un correo de confirmación al crearla. Límite de alertas y canales según el plan (`ajustes`). Previsualiza antes con `alertas_previsualizar`.
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['nombre', 'criterios', 'tipos', 'cadencia', 'canales'], 'properties': {'tipos': {'type': 'array', 'items': {'enum': ['new', 'price_drop', 'ending', 'status'], 'type': 'string'}, 'minItems': 1, 'description': '`new`, `price_drop`, `ending`, `status`'}, 'nombre': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Nombre de la alerta'}, 'canales': {'type': 'array', 'items': {'enum': ['inapp', 'email', 'push', 'telegram', 'webhook'], 'type': 'string'}, 'description': '`inapp` siempre; `email`; `push`/`telegram`/`webhook` según el plan'}, 'cadencia': {'enum': ['instant', 'daily', 'weekly'], 'type': 'string', 'description': '`instant` requiere plan Pro (si no, pasa a `daily`)'}, 'criterios': {'type': 'object', 'properties': {'m2Max': {'type': 'number', 'minimum': 0}, 'm2Min': {'type': 'number', 'minimum': 0}, 'keywords': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'maxItems': 10, 'description': 'Palabras clave (máx. 10Ã\x9740). NO filtran por zona: usa provincia/municipio'}, 'occupied': {'type': 'boolean', 'description': 'Solo ocupadas (true) o solo libres (false)'}, 'priceMax': {'type': 'number', 'minimum': 0}, 'priceMin': {'type': 'number', 'minimum': 0}, 'scoreMin': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Scoring mÃ\xadnimo (0-100): requiere plan Pro'}, 'propertyTypes': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'maxItems': 20, 'description': 'Valores EXACTOS del recurso `subastech://tipos-de-inmueble`'}, 'provinceSlugs': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$', 'description': 'Slug en minúsculas (p. ej. `madrid`)'}, 'maxItems': 60, 'description': 'Slugs de provincia'}, 'discountMinPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Descuento mÃ\xadnimo sobre tasación (%): requiere plan Pro'}, 'priceDropMinPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Para el tipo `price_drop`: bajada mÃ\xadnima (%)'}, 'endingWithinDays': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Para el tipo `ending`: dÃ\xadas antes del fin'}, 'municipalityKeys': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]+:[a-z0-9-]+$', 'description': 'Clave `provincia:municipio` (de `estadisticas_publicas`)'}, 'maxItems': 100, 'description': 'Claves `provincia:municipio` (de `estadisticas_publicas`)'}}, 'description': 'Filtros que debe cumplir una subasta para disparar la alerta: provincias, municipios, tipo de inmueble, precio, superficie y ocupación.', 'additionalProperties': False}, 'quiet_hours': {'type': 'object', 'properties': {'to': {'type': 'string', 'pattern': '^\\d{2}:\\d{2}$', 'description': 'HH:MM'}, 'days': {'type': 'array', 'items': {'type': 'integer', 'maximum': 6, 'minimum': 0}, 'maxItems': 7, 'description': '0 = domingo â\x80¦ 6 = sábado'}, 'from': {'type': 'string', 'pattern': '^\\d{2}:\\d{2}$', 'description': 'HH:MM'}, 'paused': {'type': 'boolean'}}, 'description': 'Franja en la que no se envÃ\xadan avisos. `paused` la desactiva; `from` y `to` en formato HH:MM; `days` con 0 = domingo â\x80¦ 6 = sábado.', 'additionalProperties': False}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ok', 'url'], 'properties': {'id': {'type': 'string'}, 'ok': {'type': 'boolean'}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'url': {'type': 'string'}, 'avisos': {'type': 'array', 'items': {'type': 'object', 'required': ['message'], 'properties': {'fix': {}, 'code': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': {}}}, 'ajustes': {'type': 'array', 'items': {'type': 'string'}}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
alertas_editar
Editar una alerta
Modifica una alerta existente (nombre, criterios, tipos, cadencia, canales, horas de silencio). Requiere cuenta verificada (scope `alertas:write`). No envía correo.
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id', 'nombre', 'criterios', 'tipos', 'cadencia', 'canales'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la alerta a modificar (de `alertas_listar`).'}, 'tipos': {'type': 'array', 'items': {'enum': ['new', 'price_drop', 'ending', 'status'], 'type': 'string'}, 'minItems': 1, 'description': '`new`, `price_drop`, `ending`, `status`'}, 'nombre': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Nombre de la alerta'}, 'canales': {'type': 'array', 'items': {'enum': ['inapp', 'email', 'push', 'telegram', 'webhook'], 'type': 'string'}, 'description': '`inapp` siempre; `email`; `push`/`telegram`/`webhook` según el plan'}, 'cadencia': {'enum': ['instant', 'daily', 'weekly'], 'type': 'string', 'description': '`instant` requiere plan Pro (si no, pasa a `daily`)'}, 'criterios': {'type': 'object', 'properties': {'m2Max': {'type': 'number', 'minimum': 0}, 'm2Min': {'type': 'number', 'minimum': 0}, 'keywords': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'maxItems': 10, 'description': 'Palabras clave (máx. 10Ã\x9740). NO filtran por zona: usa provincia/municipio'}, 'occupied': {'type': 'boolean', 'description': 'Solo ocupadas (true) o solo libres (false)'}, 'priceMax': {'type': 'number', 'minimum': 0}, 'priceMin': {'type': 'number', 'minimum': 0}, 'scoreMin': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Scoring mÃ\xadnimo (0-100): requiere plan Pro'}, 'propertyTypes': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'maxItems': 20, 'description': 'Valores EXACTOS del recurso `subastech://tipos-de-inmueble`'}, 'provinceSlugs': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$', 'description': 'Slug en minúsculas (p. ej. `madrid`)'}, 'maxItems': 60, 'description': 'Slugs de provincia'}, 'discountMinPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Descuento mÃ\xadnimo sobre tasación (%): requiere plan Pro'}, 'priceDropMinPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Para el tipo `price_drop`: bajada mÃ\xadnima (%)'}, 'endingWithinDays': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Para el tipo `ending`: dÃ\xadas antes del fin'}, 'municipalityKeys': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]+:[a-z0-9-]+$', 'description': 'Clave `provincia:municipio` (de `estadisticas_publicas`)'}, 'maxItems': 100, 'description': 'Claves `provincia:municipio` (de `estadisticas_publicas`)'}}, 'description': 'Filtros que debe cumplir una subasta para disparar la alerta: provincias, municipios, tipo de inmueble, precio, superficie y ocupación.', 'additionalProperties': False}, 'quiet_hours': {'type': 'object', 'properties': {'to': {'type': 'string', 'pattern': '^\\d{2}:\\d{2}$', 'description': 'HH:MM'}, 'days': {'type': 'array', 'items': {'type': 'integer', 'maximum': 6, 'minimum': 0}, 'maxItems': 7, 'description': '0 = domingo â\x80¦ 6 = sábado'}, 'from': {'type': 'string', 'pattern': '^\\d{2}:\\d{2}$', 'description': 'HH:MM'}, 'paused': {'type': 'boolean'}}, 'description': 'Franja en la que no se envÃ\xadan avisos. `paused` la desactiva; `from` y `to` en formato HH:MM; `days` con 0 = domingo â\x80¦ 6 = sábado.', 'additionalProperties': False}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ok', 'url'], 'properties': {'id': {'type': 'string'}, 'ok': {'type': 'boolean'}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'url': {'type': 'string'}, 'avisos': {'type': 'array', 'items': {'type': 'object', 'required': ['message'], 'properties': {'fix': {}, 'code': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': {}}}, 'ajustes': {'type': 'array', 'items': {'type': 'string'}}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
alertas_eliminar
Eliminar una alerta
Elimina una alerta tuya de forma permanente. Requiere cuenta verificada (scope `alertas:write`).
Destructif Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la alerta a eliminar (de `alertas_listar`).'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
alertas_listar
Listar mis alertas
Lista tus alertas de subastas con sus criterios, tipos de aviso, cadencia, canales y estado. Requiere cuenta (scope `alertas:read`). Paginada (`pagina`, `por_pagina`; máximo 20 por página): usa `total`, `paginas` y `hasMore` para pedir la siguiente.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limite': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Alias de `por_pagina` (número de resultados por página). Si indicas los dos, manda `por_pagina`.'}, 'pagina': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Página (â\x89¥1; 1 por defecto)'}, 'por_pagina': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Resultados por página (1..20; 20 por defecto)'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['alertas', 'pagina', 'por_pagina', 'total', 'paginas', 'hasMore'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'total': {'type': 'number'}, 'pagina': {'type': 'number'}, 'alertas': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'nombre', 'criterios', 'tipos', 'cadencia', 'canales', 'activa'], 'properties': {'id': {'type': 'string'}, 'tipos': {'type': 'array', 'items': {'type': 'string'}}, 'activa': {'type': 'boolean'}, 'nombre': {'type': 'string'}, 'canales': {'type': 'array', 'items': {'type': 'string'}}, 'cadencia': {'type': 'string'}, 'criterios': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'descripcion': {'type': 'string'}, 'quiet_hours': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ultima_notificacion': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'hasMore': {'type': 'boolean'}, 'paginas': {'type': 'number'}, 'disclosure': {'type': 'string'}, 'por_pagina': {'type': 'number'}}, 'additionalProperties': {}}
alertas_previsualizar
Previsualizar una alerta
Antes de crear una alerta: cuántas subastas coinciden ahora con los criterios, una muestra y avisos con `fix` aplicable (criterios sospechosos). Requiere cuenta (scope `alertas:read`). Los criterios avanzados (`scoreMin`, `discountMinPct`) requieren plan Pro; si no, se ignoran y se informa en `ajustes`.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['criterios'], 'properties': {'criterios': {'type': 'object', 'properties': {'m2Max': {'type': 'number', 'minimum': 0}, 'm2Min': {'type': 'number', 'minimum': 0}, 'keywords': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'maxItems': 10, 'description': 'Palabras clave (máx. 10Ã\x9740). NO filtran por zona: usa provincia/municipio'}, 'occupied': {'type': 'boolean', 'description': 'Solo ocupadas (true) o solo libres (false)'}, 'priceMax': {'type': 'number', 'minimum': 0}, 'priceMin': {'type': 'number', 'minimum': 0}, 'scoreMin': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Scoring mÃ\xadnimo (0-100): requiere plan Pro'}, 'propertyTypes': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'maxItems': 20, 'description': 'Valores EXACTOS del recurso `subastech://tipos-de-inmueble`'}, 'provinceSlugs': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$', 'description': 'Slug en minúsculas (p. ej. `madrid`)'}, 'maxItems': 60, 'description': 'Slugs de provincia'}, 'discountMinPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Descuento mÃ\xadnimo sobre tasación (%): requiere plan Pro'}, 'priceDropMinPct': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Para el tipo `price_drop`: bajada mÃ\xadnima (%)'}, 'endingWithinDays': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Para el tipo `ending`: dÃ\xadas antes del fin'}, 'municipalityKeys': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]+:[a-z0-9-]+$', 'description': 'Clave `provincia:municipio` (de `estadisticas_publicas`)'}, 'maxItems': 100, 'description': 'Claves `provincia:municipio` (de `estadisticas_publicas`)'}}, 'description': 'Filtros que debe cumplir una subasta para disparar la alerta: provincias, municipios, tipo de inmueble, precio, superficie y ocupación.', 'additionalProperties': False}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['criterios_limpios', 'coinciden', 'muestra', 'avisos', 'ajustes'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'avisos': {'type': 'array', 'items': {'type': 'object', 'required': ['message'], 'properties': {'fix': {}, 'code': {'type': 'string'}, 'message': {'type': 'string'}}, 'additionalProperties': {}}}, 'ajustes': {'type': 'array', 'items': {'type': 'string'}}, 'muestra': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada', 'suspendida'], 'type': 'string'}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'coinciden': {'type': 'object', 'required': ['count', 'capped'], 'properties': {'count': {'type': 'number'}, 'capped': {'type': 'boolean'}}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}, 'criterios_limpios': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': {}}
analisis_subasta
Análisis de una subasta (veredicto y ejes)
Veredicto de viabilidad y ejes (cargas, posesión, rentabilidad, titularidad) de una subasta. Requiere cuenta (scope `informes:read`) y plan Pro o superior; con Radar/Starter devuelve `locked` con `upgradeUrl`. No consume cuota.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['subasta', 'analisis_listo', 'informe_url'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'ejes': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'locked': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'object', 'required': ['locked', 'feature', 'label', 'plansLabel', 'requiredPlan', 'upgradeUrl', 'loginUrl'], 'properties': {'label': {'type': 'string'}, 'title': {'type': 'string'}, 'locked': {'type': 'boolean', 'const': True}, 'feature': {'type': 'string'}, 'loginUrl': {'type': 'string'}, 'plansLabel': {'type': 'string'}, 'upgradeUrl': {'type': 'string'}, 'requiredPlan': {'anyOf': [{'type': 'object', 'required': ['key', 'name', 'priceMonth', 'priceMonthLabel'], 'properties': {'key': {'type': 'string'}, 'name': {'type': 'string'}, 'priceMonth': {'type': 'number'}, 'priceMonthLabel': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'subasta': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'axes': {'anyOf': [{'type': 'object', 'required': ['cargas', 'posesion', 'rentab', 'titularidad'], 'properties': {'cargas': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rentab': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'posesion': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'titularidad': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'level': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada', 'suspendida'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'veredicto': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}, 'informe_url': {'type': 'string'}, 'analisis_listo': {'type': 'boolean', 'description': 'false si polSaaS aún está generando el veredicto'}}, 'additionalProperties': {}}
buscar_por_codigo
Buscar por referencia catastral, CRU, IDUFIR o BOE
Localiza subastas del BOE a partir de códigos: referencia catastral, CRU, IDUFIR o identificador BOE (hasta 5). Pública, sin cuenta; sin cuenta solo devuelve fichas vigentes en el catálogo público (con cuenta, también las archivadas con `archivada: true`).
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['codigos'], 'properties': {'codigos': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60, 'minLength': 3}, 'maxItems': 5, 'minItems': 1, 'description': 'Referencias catastrales, CRU, IDUFIR o identificadores BOE (1..5)'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['items', 'no_encontrados'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada', 'suspendida'], 'type': 'string'}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'archivada': {'type': 'boolean'}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'disclosure': {'type': 'string'}, 'no_encontrados': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': {}}
buscar_subastas
Buscar subastas
Busca subastas judiciales de inmuebles del BOE por provincia, municipio, tipo, precio, superficie, texto libre, zona (bbox o radio) y estado. Pública, sin cuenta: devuelve datos oficiales del BOE y la URL de cada ficha. El scoring, veredicto, cargas, ROI, valoración e intervinientes requieren cuenta y plan Pro o superior; si algo está cerrado se devuelve `locked` con `upgradeUrl`. Sin plan con scoring, `orden: score` pasa a `recent` y `solo_viables` se ignora (campo `degradado`). Máximo 20 por página (`por_pagina`, o su alias `limite`); no acepta parámetros que no estén declarados.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'bbox': {'type': 'object', 'required': ['oeste', 'sur', 'este', 'norte'], 'properties': {'sur': {'type': 'number'}, 'este': {'type': 'number'}, 'norte': {'type': 'number'}, 'oeste': {'type': 'number'}}, 'description': 'Zona rectangular en grados (lon/lat)', 'additionalProperties': False}, 'tipo': {'type': 'array', 'items': {'type': 'string', 'maxLength': 60, 'minLength': 1}, 'maxItems': 10, 'description': 'Tipos de inmueble, valores EXACTOS de `estadisticas_publicas.tipos` (p. ej. `Vivienda`, `Garaje`)'}, 'cerca': {'type': 'object', 'required': ['lat', 'lon', 'km'], 'properties': {'km': {'type': 'number', 'maximum': 50, 'exclusiveMinimum': 0}, 'lat': {'type': 'number', 'maximum': 90, 'minimum': -90}, 'lon': {'type': 'number', 'maximum': 180, 'minimum': -180}}, 'description': 'Radio alrededor de un punto (máximo 50 km)', 'additionalProperties': False}, 'orden': {'enum': ['recent', 'ending', 'discount', 'price', 'score'], 'type': 'string', 'description': '`recent` (por defecto), `ending`, `discount`, `price`; `score` solo con plan Pro (si no, pasa a `recent`)'}, 'texto': {'type': 'string', 'maxLength': 120, 'description': 'Texto libre (calle, barrio, juzgadoâ\x80¦), máximo 120 caracteres'}, 'estado': {'enum': ['activas', 'todas', 'adjudicadas', 'desiertas'], 'type': 'string', 'description': '`activas` (por defecto), `todas`, `adjudicadas` o `desiertas`'}, 'limite': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Alias de `por_pagina` (número de resultados por página). Si indicas los dos, manda `por_pagina`.'}, 'pagina': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Página (â\x89¥1; máximo 25 sin cuenta, 50 con cuenta)'}, 'area_max': {'type': 'number', 'minimum': 0, 'description': 'Superficie construida máxima (m²)'}, 'area_min': {'type': 'number', 'minimum': 0, 'description': 'Superficie construida mÃ\xadnima (m²)'}, 'municipio': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]+:[a-z0-9-]+$', 'description': 'Clave `provincia:municipio` (de `estadisticas_publicas`)'}, 'maxItems': 20, 'description': 'Claves `provincia:municipio` (de `estadisticas_publicas` con `municipio_q`)'}, 'provincia': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$', 'description': 'Slug en minúsculas (p. ej. `madrid`)'}, 'maxItems': 10, 'description': 'Slugs de provincia (p. ej. [`madrid`, `barcelona`]); ver `estadisticas_publicas`'}, 'por_pagina': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Resultados por página (1..20)'}, 'precio_max': {'type': 'number', 'minimum': 0, 'description': 'Valor de subasta máximo (euros)'}, 'precio_min': {'type': 'number', 'minimum': 0, 'description': 'Valor de subasta mÃ\xadnimo (euros)'}, 'solo_viables': {'type': 'boolean', 'description': 'Ocultar las no recomendables: solo con plan Pro (si no, se ignora)'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['items', 'pagina', 'por_pagina', 'total', 'paginas', 'hasMore'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada', 'suspendida'], 'type': 'string'}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'total': {'type': 'number'}, 'locked': {'type': 'object', 'properties': {'scoring': {'type': 'object', 'required': ['locked', 'feature', 'label', 'plansLabel', 'requiredPlan', 'upgradeUrl', 'loginUrl'], 'properties': {'label': {'type': 'string'}, 'title': {'type': 'string'}, 'locked': {'type': 'boolean', 'const': True}, 'feature': {'type': 'string'}, 'loginUrl': {'type': 'string'}, 'plansLabel': {'type': 'string'}, 'upgradeUrl': {'type': 'string'}, 'requiredPlan': {'anyOf': [{'type': 'object', 'required': ['key', 'name', 'priceMonth', 'priceMonthLabel'], 'properties': {'key': {'type': 'string'}, 'name': {'type': 'string'}, 'priceMonth': {'type': 'number'}, 'priceMonthLabel': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'pagina': {'type': 'number'}, 'hasMore': {'type': 'boolean'}, 'paginas': {'type': 'number'}, 'degradado': {'type': 'array', 'items': {'type': 'string'}}, 'disclosure': {'type': 'string'}, 'por_pagina': {'type': 'number'}}, 'additionalProperties': {}}
cancel_checkout
Cancelar checkout (UCP)
Cancela una sesión de checkout UCP abierta (libera cualquier borrador de pedido). Una sesión completada o cancelada no cambia. Requiere meta['idempotency-key'] además de meta['ucp-agent'].
Destructif Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['meta', 'id'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la sesión de checkout a cancelar (de create_checkout).'}, 'meta': {'type': 'object', 'required': ['ucp-agent'], 'properties': {'ucp-agent': {'type': 'object', 'required': ['profile'], 'properties': {'profile': {'type': 'string', 'maxLength': 512, 'description': 'URL del perfil UCP de la plataforma (/.well-known/ucp)'}}, 'description': 'Identificación de la plataforma (equivale a la cabecera UCP-Agent). Obligatorio.', 'additionalProperties': {}}, 'request-id': {'type': 'string', 'maxLength': 128}, 'idempotency-key': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Clave de idempotencia (UUID). Obligatoria en complete_checkout y cancel_checkout.'}}, 'description': 'Metadatos de la llamada UCP: `ucp-agent` identifica la plataforma y es obligatorio; `idempotency-key` (UUID) lo es en complete_checkout y cancel_checkout.', 'additionalProperties': {}}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ucp'], 'properties': {'id': {'type': 'string'}, 'ucp': {'type': 'object', 'required': ['version'], 'properties': {'status': {'enum': ['success', 'error'], 'type': 'string'}, 'version': {'type': 'string', 'const': '2026-08-25'}, 'capabilities': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment_handlers': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'links': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'url'], 'properties': {'url': {'type': 'string'}, 'type': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}, 'order': {'type': 'object', 'required': ['id', 'permalink_url'], 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}, 'permalink_url': {'type': 'string'}}, 'additionalProperties': {}}, 'status': {'enum': ['incomplete', 'requires_escalation', 'ready_for_complete', 'complete_in_progress', 'completed', 'canceled'], 'type': 'string'}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}}, 'additionalProperties': {}}, 'currency': {'type': 'string'}, 'messages': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'content'], 'properties': {'code': {'type': 'string'}, 'path': {'type': 'string'}, 'type': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'content': {'type': 'string'}, 'severity': {'enum': ['recoverable', 'requires_buyer_input', 'requires_buyer_review', 'unrecoverable'], 'type': 'string'}}, 'additionalProperties': {}}}, 'expires_at': {'type': 'string'}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'item', 'quantity', 'totals'], 'properties': {'id': {'type': 'string'}, 'item': {'type': 'object', 'required': ['id', 'title', 'price'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'title': {'type': 'string'}}, 'additionalProperties': {}}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'continue_url': {'type': 'string'}}, 'additionalProperties': {}}
complete_checkout
Completar checkout (UCP)
Completa una sesión de checkout UCP. Sin manejador de pago nativo: si checkout.payment.instruments[] trae una credencial Shared Payment Token de Stripe (handler_id 'stripe', credential.token 'spt_…') se cobra y se entrega al instante; si no, la sesión pasa a requires_escalation y el comprador termina en continue_url. Un informe incluido en el plan se completa sin cobro. Requiere meta['idempotency-key'] además de meta['ucp-agent'].
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['meta', 'id'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la sesión de checkout a completar (de create_checkout).'}, 'meta': {'type': 'object', 'required': ['ucp-agent'], 'properties': {'ucp-agent': {'type': 'object', 'required': ['profile'], 'properties': {'profile': {'type': 'string', 'maxLength': 512, 'description': 'URL del perfil UCP de la plataforma (/.well-known/ucp)'}}, 'description': 'Identificación de la plataforma (equivale a la cabecera UCP-Agent). Obligatorio.', 'additionalProperties': {}}, 'request-id': {'type': 'string', 'maxLength': 128}, 'idempotency-key': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Clave de idempotencia (UUID). Obligatoria en complete_checkout y cancel_checkout.'}}, 'description': 'Metadatos de la llamada UCP: `ucp-agent` identifica la plataforma y es obligatorio; `idempotency-key` (UUID) lo es en complete_checkout y cancel_checkout.', 'additionalProperties': {}}, 'checkout': {'type': 'object', 'properties': {'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 200}, 'type': {'type': 'string', 'maxLength': 80}, 'selected': {'type': 'boolean'}, 'credential': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 80}}, 'additionalProperties': {}}, 'handler_id': {'type': 'string', 'maxLength': 200}}, 'additionalProperties': {}}, 'maxItems': 10}}, 'additionalProperties': {}}, 'signals': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'description': 'Datos finales del pedido si han cambiado. AquÃ\xad viaja la credencial de pago: un Shared Payment Token de Stripe en `payment.instruments[]` se cobra al instante.', 'additionalProperties': {}}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ucp'], 'properties': {'id': {'type': 'string'}, 'ucp': {'type': 'object', 'required': ['version'], 'properties': {'status': {'enum': ['success', 'error'], 'type': 'string'}, 'version': {'type': 'string', 'const': '2026-08-25'}, 'capabilities': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment_handlers': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'links': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'url'], 'properties': {'url': {'type': 'string'}, 'type': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}, 'order': {'type': 'object', 'required': ['id', 'permalink_url'], 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}, 'permalink_url': {'type': 'string'}}, 'additionalProperties': {}}, 'status': {'enum': ['incomplete', 'requires_escalation', 'ready_for_complete', 'complete_in_progress', 'completed', 'canceled'], 'type': 'string'}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}}, 'additionalProperties': {}}, 'currency': {'type': 'string'}, 'messages': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'content'], 'properties': {'code': {'type': 'string'}, 'path': {'type': 'string'}, 'type': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'content': {'type': 'string'}, 'severity': {'enum': ['recoverable', 'requires_buyer_input', 'requires_buyer_review', 'unrecoverable'], 'type': 'string'}}, 'additionalProperties': {}}}, 'expires_at': {'type': 'string'}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'item', 'quantity', 'totals'], 'properties': {'id': {'type': 'string'}, 'item': {'type': 'object', 'required': ['id', 'title', 'price'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'title': {'type': 'string'}}, 'additionalProperties': {}}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'continue_url': {'type': 'string'}}, 'additionalProperties': {}}
create_checkout
Crear checkout (UCP)
Crea una sesión de checkout UCP 2026-08-25 para comprar un informe de viabilidad, una nota simple registral o una suscripción de Subastech. Productos (item.id): informe:basico:<publicId> (49 € o incluido según plan), informe:completo:<publicId> (79 € o incluido), nota-simple:<publicId> o nota-simple:cru:<14 dígitos> (20 €, solo se cobra con el PDF verificado) y plan:<starter|pro|team|enterprise>:<month|year> (la suscripción se completa en el navegador). Un producto por sesión, quantity 1. Precios con IVA. Indica checkout.buyer.email: se crea o vincula la cuenta del comprador y recibe un enlace de acceso por correo (o autentícate con un token de Subastech). Devuelve el objeto Checkout (status, line_items, totals, messages, links). Requiere meta['ucp-agent'] = { profile: 'https://<plataforma>/.well-known/ucp' } (identificación de la plataforma UCP).
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['meta', 'checkout'], 'properties': {'meta': {'type': 'object', 'required': ['ucp-agent'], 'properties': {'ucp-agent': {'type': 'object', 'required': ['profile'], 'properties': {'profile': {'type': 'string', 'maxLength': 512, 'description': 'URL del perfil UCP de la plataforma (/.well-known/ucp)'}}, 'description': 'Identificación de la plataforma (equivale a la cabecera UCP-Agent). Obligatorio.', 'additionalProperties': {}}, 'request-id': {'type': 'string', 'maxLength': 128}, 'idempotency-key': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Clave de idempotencia (UUID). Obligatoria en complete_checkout y cancel_checkout.'}}, 'description': 'Metadatos de la llamada UCP: `ucp-agent` identifica la plataforma y es obligatorio; `idempotency-key` (UUID) lo es en complete_checkout y cancel_checkout.', 'additionalProperties': {}}, 'checkout': {'type': 'object', 'required': ['line_items'], 'properties': {'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'context': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 200}, 'type': {'type': 'string', 'maxLength': 80}, 'selected': {'type': 'boolean'}, 'credential': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 80}}, 'additionalProperties': {}}, 'handler_id': {'type': 'string', 'maxLength': 200}}, 'additionalProperties': {}}, 'maxItems': 10}}, 'additionalProperties': {}}, 'signals': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['item'], 'properties': {'id': {'type': 'string', 'maxLength': 200}, 'item': {'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Identificador del producto: informe:basico:<publicId>, informe:completo:<publicId>, nota-simple:<publicId>, nota-simple:cru:<14 dÃ\xadgitos> o plan:<key>:<month|year>'}}, 'additionalProperties': {}}, 'quantity': {'type': 'integer', 'default': 1, 'maximum': 1000000, 'minimum': 1}}, 'additionalProperties': {}}, 'maxItems': 10, 'minItems': 1}, 'attribution': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'description': 'Contenido del pedido: `line_items` con los productos del catálogo (1-10) y, opcionalmente, `buyer` y `payment`.', 'additionalProperties': {}}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ucp'], 'properties': {'id': {'type': 'string'}, 'ucp': {'type': 'object', 'required': ['version'], 'properties': {'status': {'enum': ['success', 'error'], 'type': 'string'}, 'version': {'type': 'string', 'const': '2026-08-25'}, 'capabilities': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment_handlers': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'links': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'url'], 'properties': {'url': {'type': 'string'}, 'type': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}, 'order': {'type': 'object', 'required': ['id', 'permalink_url'], 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}, 'permalink_url': {'type': 'string'}}, 'additionalProperties': {}}, 'status': {'enum': ['incomplete', 'requires_escalation', 'ready_for_complete', 'complete_in_progress', 'completed', 'canceled'], 'type': 'string'}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}}, 'additionalProperties': {}}, 'currency': {'type': 'string'}, 'messages': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'content'], 'properties': {'code': {'type': 'string'}, 'path': {'type': 'string'}, 'type': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'content': {'type': 'string'}, 'severity': {'enum': ['recoverable', 'requires_buyer_input', 'requires_buyer_review', 'unrecoverable'], 'type': 'string'}}, 'additionalProperties': {}}}, 'expires_at': {'type': 'string'}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'item', 'quantity', 'totals'], 'properties': {'id': {'type': 'string'}, 'item': {'type': 'object', 'required': ['id', 'title', 'price'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'title': {'type': 'string'}}, 'additionalProperties': {}}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'continue_url': {'type': 'string'}}, 'additionalProperties': {}}
estadisticas_publicas
Estadísticas públicas del catálogo
Totales del catálogo, provincias con subastas activas e históricas, tipos de inmueble (valores EXACTOS para filtrar) y búsqueda de municipios (claves `provincia:municipio`). Pública, sin cuenta. No incluye estadísticas de mercado (herramienta `mercado`, plan Pro).
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'estado': {'enum': ['activas', 'historicas'], 'type': 'string', 'description': 'Ã\x81mbito de los tipos de inmueble'}, 'municipio_q': {'type': 'string', 'maxLength': 80, 'minLength': 2, 'description': 'Buscar municipios por nombre (â\x89¥2 caracteres)'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['totales', 'provincias', 'tipos'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'tipos': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'n'], 'properties': {'n': {'type': 'number'}, 'type': {'type': 'string'}}, 'additionalProperties': {}}}, 'totales': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}, 'municipios': {'type': 'array', 'items': {'type': 'object', 'required': ['key', 'name', 'province', 'auctionCount', 'url'], 'properties': {'key': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'province': {'type': 'string'}, 'auctionCount': {'type': 'number'}}, 'additionalProperties': {}}}, 'provincias': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'active', 'historical', 'url'], 'properties': {'url': {'type': 'string'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'active': {'type': 'number'}, 'historical': {'type': 'number'}}, 'additionalProperties': {}}}}, 'additionalProperties': {}}
explicar_concepto
Explicar un concepto de subastas judiciales
Explica un concepto de las subastas judiciales en España (depósito, cargas, posesión, cesión de remate, tipos de subasta…) desde la base de conocimiento de Subastech, redactada por personas. Pública, sin cuenta; sin modelo de lenguaje.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['pregunta'], 'properties': {'pregunta': {'type': 'string', 'maxLength': 400, 'minLength': 2, 'description': 'Concepto o pregunta (p. ej. «qué es la cesión de remate»)'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['concepto'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'fuente': {'type': 'string'}, 'concepto': {'anyOf': [{'type': 'object', 'required': ['id', 'respuesta_md'], 'properties': {'id': {'type': 'string'}, 'titulo': {'type': 'string'}, 'respuesta_md': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'disclosure': {'type': 'string'}, 'sugerencia': {'type': 'string'}, 'relacionados': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': {}}
favoritos_anadir
Guardar en favoritos
Guarda una subasta en tus favoritos. Requiere cuenta (scope `favoritos:write`). Radar y Starter solo pueden guardar subastas activas (`fav.historico` es Pro+).
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ok', 'favorito'], 'properties': {'ok': {'type': 'boolean'}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'favorito': {'type': 'boolean'}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
favoritos_listar
Listar mis favoritos
Subastas que has guardado como favoritas. Requiere cuenta (scope `favoritos:read`). Paginada (`pagina`, `por_pagina`; máximo 20 por página): usa `total`, `paginas` y `hasMore` para pedir la siguiente. El scoring, veredicto, cargas, ROI, valoración e intervinientes requieren cuenta y plan Pro o superior; si algo está cerrado se devuelve `locked` con `upgradeUrl`.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limite': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Alias de `por_pagina` (número de resultados por página). Si indicas los dos, manda `por_pagina`.'}, 'pagina': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Página (â\x89¥1; 1 por defecto)'}, 'por_pagina': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Resultados por página (1..20; 20 por defecto)'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['items', 'pagina', 'por_pagina', 'total', 'paginas', 'hasMore'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'axes': {'anyOf': [{'type': 'object', 'required': ['cargas', 'posesion', 'rentab', 'titularidad'], 'properties': {'cargas': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rentab': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'posesion': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'titularidad': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'level': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada', 'suspendida'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'total': {'type': 'number'}, 'pagina': {'type': 'number'}, 'hasMore': {'type': 'boolean'}, 'paginas': {'type': 'number'}, 'disclosure': {'type': 'string'}, 'por_pagina': {'type': 'number'}}, 'additionalProperties': {}}
favoritos_quitar
Quitar de favoritos
Quita una subasta de tus favoritos. Requiere cuenta (scope `favoritos:write`).
Destructif Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ok', 'favorito'], 'properties': {'ok': {'type': 'boolean'}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'favorito': {'type': 'boolean'}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
fetch
Fetch (ChatGPT)
Lee una ficha de subasta por `id` (compatible con la búsqueda profunda de ChatGPT): `id`, `title`, `text` con los datos públicos del BOE en Markdown, `url` y `metadata`. Pública, sin cuenta. El scoring, veredicto, cargas, ROI, valoración e intervinientes requieren cuenta y plan Pro o superior; si algo está cerrado se devuelve `locked` con `upgradeUrl`.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 400, 'minLength': 1, 'description': '`id` devuelto por `search` (o URL de la ficha)'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id', 'title', 'text', 'url', 'metadata'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'text': {'type': 'string'}, 'title': {'type': 'string'}, 'metadata': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': {}}
get_checkout
Consultar checkout (UCP)
Devuelve el estado actual de una sesión de checkout UCP por id (incomplete, ready_for_complete, requires_escalation, complete_in_progress, completed, canceled), con messages, continue_url y order cuando existan. Requiere meta['ucp-agent'] = { profile: 'https://<plataforma>/.well-known/ucp' } (identificación de la plataforma UCP).
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['meta', 'id'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la sesión de checkout a consultar (de create_checkout).'}, 'meta': {'type': 'object', 'required': ['ucp-agent'], 'properties': {'ucp-agent': {'type': 'object', 'required': ['profile'], 'properties': {'profile': {'type': 'string', 'maxLength': 512, 'description': 'URL del perfil UCP de la plataforma (/.well-known/ucp)'}}, 'description': 'Identificación de la plataforma (equivale a la cabecera UCP-Agent). Obligatorio.', 'additionalProperties': {}}, 'request-id': {'type': 'string', 'maxLength': 128}, 'idempotency-key': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Clave de idempotencia (UUID). Obligatoria en complete_checkout y cancel_checkout.'}}, 'description': 'Metadatos de la llamada UCP: `ucp-agent` identifica la plataforma y es obligatorio; `idempotency-key` (UUID) lo es en complete_checkout y cancel_checkout.', 'additionalProperties': {}}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ucp'], 'properties': {'id': {'type': 'string'}, 'ucp': {'type': 'object', 'required': ['version'], 'properties': {'status': {'enum': ['success', 'error'], 'type': 'string'}, 'version': {'type': 'string', 'const': '2026-08-25'}, 'capabilities': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment_handlers': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'links': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'url'], 'properties': {'url': {'type': 'string'}, 'type': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}, 'order': {'type': 'object', 'required': ['id', 'permalink_url'], 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}, 'permalink_url': {'type': 'string'}}, 'additionalProperties': {}}, 'status': {'enum': ['incomplete', 'requires_escalation', 'ready_for_complete', 'complete_in_progress', 'completed', 'canceled'], 'type': 'string'}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}}, 'additionalProperties': {}}, 'currency': {'type': 'string'}, 'messages': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'content'], 'properties': {'code': {'type': 'string'}, 'path': {'type': 'string'}, 'type': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'content': {'type': 'string'}, 'severity': {'enum': ['recoverable', 'requires_buyer_input', 'requires_buyer_review', 'unrecoverable'], 'type': 'string'}}, 'additionalProperties': {}}}, 'expires_at': {'type': 'string'}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'item', 'quantity', 'totals'], 'properties': {'id': {'type': 'string'}, 'item': {'type': 'object', 'required': ['id', 'title', 'price'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'title': {'type': 'string'}}, 'additionalProperties': {}}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'continue_url': {'type': 'string'}}, 'additionalProperties': {}}
informe
Informe de viabilidad
Informe de viabilidad de una subasta con las secciones que tu plan permite (resumen, cargas, descripción, catastro, calculadora, valoración, intervinientes, estadísticas); las cerradas se listan en `locked`. Requiere cuenta verificada (scope `informes:read`). Los tiers `basic`/`completo` solo se sirven si ya están desbloqueados: si no, devuelve `unlock_required` con la URL para desbloquearlos en el navegador (y, si el comercio para agentes está activo, `compra.paymentLink` para pagarlos por MPP). Nunca consume cuota ni cobra por sí misma. Parte del texto se genera con IA (`disclosure`).
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}, 'tier': {'enum': ['web', 'basic', 'completo'], 'type': 'string', 'description': '`web` (por defecto, según tu plan), `basic` o `completo` (solo si ya están desbloqueados)'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['subasta', 'tier', 'secciones', 'locked', 'analisis_listo', 'informe_url'], 'properties': {'ai': {'type': 'object', 'required': ['generated', 'system'], 'properties': {'note': {'type': 'string'}, 'system': {'type': 'string'}, 'generated': {'type': 'boolean'}}, 'additionalProperties': {}}, 'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'tier': {'enum': ['web', 'basic', 'completo'], 'type': 'string'}, 'compra': {'type': 'object', 'required': ['paymentLink', 'precio_cents', 'moneda', 'instrucciones'], 'properties': {'moneda': {'type': 'string', 'const': 'EUR'}, 'paymentLink': {'type': 'string', 'description': 'URL de pago máquina (MPP/Stripe): POST â\x86\x92 402 con reto â\x86\x92 reintento con Shared Payment Token; en navegador, checkout humano'}, 'precio_cents': {'type': 'number'}, 'precio_label': {'type': 'string'}, 'instrucciones': {'type': 'object', 'required': ['agente', 'navegador'], 'properties': {'agente': {'type': 'string'}, 'navegador': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'locked': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'object', 'required': ['locked', 'feature', 'label', 'plansLabel', 'requiredPlan', 'upgradeUrl', 'loginUrl'], 'properties': {'label': {'type': 'string'}, 'title': {'type': 'string'}, 'locked': {'type': 'boolean', 'const': True}, 'feature': {'type': 'string'}, 'loginUrl': {'type': 'string'}, 'plansLabel': {'type': 'string'}, 'upgradeUrl': {'type': 'string'}, 'requiredPlan': {'anyOf': [{'type': 'object', 'required': ['key', 'name', 'priceMonth', 'priceMonthLabel'], 'properties': {'key': {'type': 'string'}, 'name': {'type': 'string'}, 'priceMonth': {'type': 'number'}, 'priceMonthLabel': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'pdfUrl': {'type': 'string'}, 'subasta': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'axes': {'anyOf': [{'type': 'object', 'required': ['cargas', 'posesion', 'rentab', 'titularidad'], 'properties': {'cargas': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rentab': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'posesion': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'titularidad': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'level': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada', 'suspendida'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'secciones': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}, 'unlock_url': {'type': 'string'}, 'informe_url': {'type': 'string'}, 'analisis_listo': {'type': 'boolean', 'description': 'false si polSaaS aún está generando el veredicto'}}, 'additionalProperties': {}}
mercado
Estadísticas de mercado
Estadísticas de mercado de subastas resueltas (tasa de adjudicación, descuento real, precios) por provincia y/o tipo de inmueble. Requiere cuenta (scope `informes:read`) y plan Pro o superior; si no, `plan_required` con `locked`.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'tipo': {'type': 'string', 'maxLength': 60, 'minLength': 1, 'description': 'Tipo de inmueble (valor exacto)'}, 'provincia': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$', 'description': 'Slug en minúsculas (p. ej. `madrid`)'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ambito', 'stats'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'stats': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ambito': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'locked': {'type': 'object', 'required': ['locked', 'feature', 'label', 'plansLabel', 'requiredPlan', 'upgradeUrl', 'loginUrl'], 'properties': {'label': {'type': 'string'}, 'title': {'type': 'string'}, 'locked': {'type': 'boolean', 'const': True}, 'feature': {'type': 'string'}, 'loginUrl': {'type': 'string'}, 'plansLabel': {'type': 'string'}, 'upgradeUrl': {'type': 'string'}, 'requiredPlan': {'anyOf': [{'type': 'object', 'required': ['key', 'name', 'priceMonth', 'priceMonthLabel'], 'properties': {'key': {'type': 'string'}, 'name': {'type': 'string'}, 'priceMonth': {'type': 'number'}, 'priceMonthLabel': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'minimo': {'type': 'number'}, 'disclosure': {'type': 'string'}, 'muestra_insuficiente': {'type': 'boolean'}}, 'additionalProperties': {}}
mi_cuenta
Mi cuenta
Tu plan, cuota de informes, funciones disponibles, scopes del token, límites de uso y URLs útiles (precios, integraciones). Requiere cuenta (scope `cuenta:read`).
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['usuario', 'plan', 'funciones', 'token', 'limites', 'urls'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'org': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}]}, 'plan': {'type': 'object', 'required': ['key', 'nombre'], 'properties': {'key': {'type': 'string'}, 'nombre': {'type': 'string'}, 'precio_mes': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'urls': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'token': {'type': 'object', 'required': ['kind', 'scopes'], 'properties': {'kind': {'type': 'string'}, 'client': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'scopes': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': {}}, 'limites': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'usuario': {'type': 'object', 'required': ['email', 'nombre', 'verificado'], 'properties': {'email': {'type': 'string'}, 'nombre': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'verificado': {'type': 'boolean'}}, 'additionalProperties': {}}, 'funciones': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'boolean'}}, 'disclosure': {'type': 'string'}, 'cuota_informes': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'additionalProperties': {}}
nota_simple_estado
Estado de una nota simple
Estado de un pedido de nota simple registral y URL para verlo o descargar el PDF cuando esté listo. Requiere cuenta (scope `notas:read`).
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['pedido_id'], 'properties': {'pedido_id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador del pedido devuelto por `nota_simple_pedir`.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['pedido', 'url'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'url': {'type': 'string'}, 'pedido': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
nota_simple_pedir
Pedir una nota simple
Inicia el pedido de la nota simple registral de una subasta (20 €, retención: solo se cobra con PDF verificado). Requiere cuenta verificada (scope `notas:write`) y que la subasta tenga CRU/IDUFIR (`not_orderable` si no). Devuelve `pedido_id` y la `url` donde el usuario confirma el pago en el navegador (y, si el comercio para agentes está activo, `paymentLink` para pagarlo por MPP); el pago nunca se completa desde aquí. Idempotente: si ya hay un pedido vivo devuelve `pedido_existente`. Máximo 20 inmuebles al día.
Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['pedido_id', 'url', 'siguiente_paso'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'url': {'type': 'string'}, 'compra': {'type': 'object', 'required': ['paymentLink', 'precio_cents', 'moneda', 'instrucciones'], 'properties': {'moneda': {'type': 'string', 'const': 'EUR'}, 'paymentLink': {'type': 'string', 'description': 'URL de pago máquina (MPP/Stripe): POST â\x86\x92 402 con reto â\x86\x92 reintento con Shared Payment Token; en navegador, checkout humano'}, 'precio_cents': {'type': 'number'}, 'precio_label': {'type': 'string'}, 'instrucciones': {'type': 'object', 'required': ['agente', 'navegador'], 'properties': {'agente': {'type': 'string'}, 'navegador': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'pedido_id': {'type': 'string'}, 'disclosure': {'type': 'string'}, 'paymentLink': {'type': 'string'}, 'precio_cents': {'type': 'number'}, 'siguiente_paso': {'type': 'string'}}, 'additionalProperties': {}}
notas_simples_listar
Listar mis notas simples
Pedidos de nota simple registral (20 €) con su estado. Requiere cuenta (scope `notas:read`). Paginada (`pagina`, `por_pagina`; máximo 20 por página): usa `total`, `paginas` y `hasMore` para pedir la siguiente.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limite': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Alias de `por_pagina` (número de resultados por página). Si indicas los dos, manda `por_pagina`.'}, 'pagina': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Página (â\x89¥1; 1 por defecto)'}, 'por_pagina': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Resultados por página (1..20; 20 por defecto)'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['pedidos', 'pagina', 'por_pagina', 'total', 'paginas', 'hasMore'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'total': {'type': 'number'}, 'pagina': {'type': 'number'}, 'hasMore': {'type': 'boolean'}, 'paginas': {'type': 'number'}, 'pedidos': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'disclosure': {'type': 'string'}, 'por_pagina': {'type': 'number'}}, 'additionalProperties': {}}
planes
Planes y precios de Subastech
Planes de Subastech (Radar gratuito, Starter, Pro, Team, Enterprise) con precios y comparativa de funciones. Pública, sin cuenta.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['planes', 'comparativa', 'url'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'url': {'type': 'string'}, 'planes': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'disclosure': {'type': 'string'}, 'comparativa': {}}, 'additionalProperties': {}}
recomendaciones
Recomendaciones para ti
Subastas recomendadas según tu historial (tipo, precio, provincias), como el bloque «para ti» de la web. Requiere cuenta (scope `cuenta:read`). Con plan Pro o superior usa el ranking por scoring; si no, se construye con tu perfil y orden por fecha de fin.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['items'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'nota': {'type': 'string'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'axes': {'anyOf': [{'type': 'object', 'required': ['cargas', 'posesion', 'rentab', 'titularidad'], 'properties': {'cargas': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rentab': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'posesion': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'titularidad': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'level': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada', 'suspendida'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'titulo': {'type': 'string'}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
resultados_recientes
Adjudicaciones recientes
Últimas subastas del BOE con resultado oficial (adjudicadas), opcionalmente por provincia, con el remate y el descuento real sobre la tasación (aritmética del BOE). Pública, sin cuenta. Máximo 15.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limite': {'type': 'integer', 'maximum': 15, 'minimum': 1, 'description': 'Máximo 15'}, 'provincia': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$', 'description': 'Slug en minúsculas (p. ej. `madrid`)'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['items'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente', 'remate', 'descuento_real_pct'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada', 'suspendida'], 'type': 'string'}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'remate': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'descuento_real_pct': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
search
Search (ChatGPT)
Búsqueda en lenguaje natural de subastas judiciales del BOE (compatible con la búsqueda profunda de ChatGPT): devuelve `results` con `id`, `title` y `url`. Pública, sin cuenta. Usa `fetch` con el `id` para leer la ficha.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Búsqueda en lenguaje natural'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}}, 'additionalProperties': {}}
similares
Subastas similares
Subastas parecidas a una dada (mismo tipo de inmueble, banda de precio, cercanía). Requiere cuenta (scope `informes:read`). Con plan Pro o superior se ordenan por scoring (`metodo: scoring`); si no, por fecha de fin (`metodo: publico`).
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}, 'limite': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Número máximo de subastas similares a devolver (1-10).'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['base', 'items', 'metodo'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'base': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'axes': {'anyOf': [{'type': 'object', 'required': ['cargas', 'posesion', 'rentab', 'titularidad'], 'properties': {'cargas': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rentab': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'posesion': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'titularidad': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'level': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada', 'suspendida'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'axes': {'anyOf': [{'type': 'object', 'required': ['cargas', 'posesion', 'rentab', 'titularidad'], 'properties': {'cargas': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rentab': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'posesion': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'titularidad': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'level': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada', 'suspendida'], 'type': 'string'}, 'score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'metodo': {'enum': ['scoring', 'publico'], 'type': 'string'}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
subasta
Ficha de una subasta
Ficha pública de una subasta del BOE por identificador (10 caracteres), URL de app.subastech.com o identificador BOE (SUB-…): dirección, valores, fechas, resultado, lotes y un resumen citable. Pública, sin cuenta. El scoring, veredicto, cargas, ROI, valoración e intervinientes requieren cuenta y plan Pro o superior; si algo está cerrado se devuelve `locked` con `upgradeUrl`.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9]{10}$', 'description': 'Identificador público de la subasta (10 caracteres)'}, 'url': {'type': 'string', 'format': 'uri', 'maxLength': 400, 'description': 'URL de la ficha en app.subastech.com'}, 'boe_id': {'type': 'string', 'maxLength': 60, 'description': 'Identificador del BOE (p. ej. `SUB-JA-2026-123456`): devuelve todos los lotes'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['subasta', 'resumen'], 'properties': {'cta': {'type': 'object', 'required': ['text', 'url'], 'properties': {'url': {'type': 'string'}, 'text': {'type': 'string'}}, 'additionalProperties': {}}, 'lotes': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada', 'suspendida'], 'type': 'string'}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'locked': {'type': 'object', 'properties': {'scoring': {'type': 'object', 'required': ['locked', 'feature', 'label', 'plansLabel', 'requiredPlan', 'upgradeUrl', 'loginUrl'], 'properties': {'label': {'type': 'string'}, 'title': {'type': 'string'}, 'locked': {'type': 'boolean', 'const': True}, 'feature': {'type': 'string'}, 'loginUrl': {'type': 'string'}, 'plansLabel': {'type': 'string'}, 'upgradeUrl': {'type': 'string'}, 'requiredPlan': {'anyOf': [{'type': 'object', 'required': ['key', 'name', 'priceMonth', 'priceMonthLabel'], 'properties': {'key': {'type': 'string'}, 'name': {'type': 'string'}, 'priceMonth': {'type': 'number'}, 'priceMonthLabel': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'resumen': {'type': 'string', 'description': 'Frase citable con los datos del BOE'}, 'subasta': {'type': 'object', 'required': ['id', 'type', 'isNew', 'title', 'address', 'municipio', 'provincia', 'cp', 'ref', 'provinceSlug', 'municipalitySlug', 'end', 'contentUpdatedAt', 'daysLeft', 'valueAuction', 'valueM2', 'minimumBid', 'deposit', 'appraisal', 'occupied', 'discount', 'm2', 'status', 'cadastral', 'imageUrl', 'lat', 'lon', 'lot', 'finalBid', 'resultStatus', 'closedAt', 'phase', 'url', 'links', 'fuente'], 'properties': {'cp': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'id': {'type': 'string'}, 'm2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lon': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lot': {'anyOf': [{'type': 'object', 'required': ['n', 'total'], 'properties': {'n': {'type': 'number'}, 'total': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'ref': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'type': 'string'}, 'type': {'type': 'string'}, 'isNew': {'type': 'boolean'}, 'links': {'type': 'object', 'required': ['streetView', 'catastroPdf'], 'properties': {'streetView': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'catastroPdf': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'phase': {'enum': ['activa', 'historica', 'descartada', 'suspendida'], 'type': 'string'}, 'title': {'type': 'string'}, 'fuente': {'type': 'string', 'const': 'BOE'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'deposit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'valueM2': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'closedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'daysLeft': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discount': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'finalBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'imageUrl': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'occupied': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'appraisal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cadastral': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipio': {'type': 'string'}, 'provincia': {'type': 'string'}, 'minimumBid': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'provinceSlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resultStatus': {'anyOf': [{'enum': ['con_pujas', 'sin_pujas', 'cancelada'], 'type': 'string'}, {'type': 'null'}]}, 'valueAuction': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'contentUpdatedAt': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'municipalitySlug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'disclosure': {'type': 'string'}}, 'additionalProperties': {}}
update_checkout
Actualizar checkout (UCP)
Reemplaza el contenido de una sesión de checkout UCP (line_items y buyer) y recalcula precio y estado. No admite sesiones en complete_in_progress ni terminadas. Requiere meta['ucp-agent'] = { profile: 'https://<plataforma>/.well-known/ucp' } (identificación de la plataforma UCP).
Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['meta', 'id', 'checkout'], 'properties': {'id': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Identificador de la sesión de checkout a modificar (de create_checkout).'}, 'meta': {'type': 'object', 'required': ['ucp-agent'], 'properties': {'ucp-agent': {'type': 'object', 'required': ['profile'], 'properties': {'profile': {'type': 'string', 'maxLength': 512, 'description': 'URL del perfil UCP de la plataforma (/.well-known/ucp)'}}, 'description': 'Identificación de la plataforma (equivale a la cabecera UCP-Agent). Obligatorio.', 'additionalProperties': {}}, 'request-id': {'type': 'string', 'maxLength': 128}, 'idempotency-key': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Clave de idempotencia (UUID). Obligatoria en complete_checkout y cancel_checkout.'}}, 'description': 'Metadatos de la llamada UCP: `ucp-agent` identifica la plataforma y es obligatorio; `idempotency-key` (UUID) lo es en complete_checkout y cancel_checkout.', 'additionalProperties': {}}, 'checkout': {'type': 'object', 'required': ['line_items'], 'properties': {'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'context': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 200}, 'type': {'type': 'string', 'maxLength': 80}, 'selected': {'type': 'boolean'}, 'credential': {'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'maxLength': 80}}, 'additionalProperties': {}}, 'handler_id': {'type': 'string', 'maxLength': 200}}, 'additionalProperties': {}}, 'maxItems': 10}}, 'additionalProperties': {}}, 'signals': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['item'], 'properties': {'id': {'type': 'string', 'maxLength': 200}, 'item': {'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Identificador del producto: informe:basico:<publicId>, informe:completo:<publicId>, nota-simple:<publicId>, nota-simple:cru:<14 dÃ\xadgitos> o plan:<key>:<month|year>'}}, 'additionalProperties': {}}, 'quantity': {'type': 'integer', 'default': 1, 'maximum': 1000000, 'minimum': 1}}, 'additionalProperties': {}}, 'maxItems': 10, 'minItems': 1}, 'attribution': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'description': 'Nuevo contenido del pedido, que sustituye al de la sesión abierta.', 'additionalProperties': {}}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ucp'], 'properties': {'id': {'type': 'string'}, 'ucp': {'type': 'object', 'required': ['version'], 'properties': {'status': {'enum': ['success', 'error'], 'type': 'string'}, 'version': {'type': 'string', 'const': '2026-08-25'}, 'capabilities': {'type': 'object', 'properties': {}, 'additionalProperties': {}}, 'payment_handlers': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'buyer': {'type': 'object', 'properties': {'email': {'type': 'string', 'maxLength': 320}, 'last_name': {'type': 'string', 'maxLength': 120}, 'first_name': {'type': 'string', 'maxLength': 120}, 'phone_number': {'type': 'string', 'maxLength': 40}}, 'additionalProperties': {}}, 'links': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'url'], 'properties': {'url': {'type': 'string'}, 'type': {'type': 'string'}, 'title': {'type': 'string'}}, 'additionalProperties': {}}}, 'order': {'type': 'object', 'required': ['id', 'permalink_url'], 'properties': {'id': {'type': 'string'}, 'label': {'type': 'string'}, 'permalink_url': {'type': 'string'}}, 'additionalProperties': {}}, 'status': {'enum': ['incomplete', 'requires_escalation', 'ready_for_complete', 'complete_in_progress', 'completed', 'canceled'], 'type': 'string'}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'payment': {'type': 'object', 'properties': {'instruments': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'additionalProperties': {}}}}, 'additionalProperties': {}}, 'currency': {'type': 'string'}, 'messages': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'content'], 'properties': {'code': {'type': 'string'}, 'path': {'type': 'string'}, 'type': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'content': {'type': 'string'}, 'severity': {'enum': ['recoverable', 'requires_buyer_input', 'requires_buyer_review', 'unrecoverable'], 'type': 'string'}}, 'additionalProperties': {}}}, 'expires_at': {'type': 'string'}, 'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'item', 'quantity', 'totals'], 'properties': {'id': {'type': 'string'}, 'item': {'type': 'object', 'required': ['id', 'title', 'price'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'title': {'type': 'string'}}, 'additionalProperties': {}}, 'totals': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'amount'], 'properties': {'type': {'type': 'string'}, 'amount': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'display_text': {'type': 'string'}}, 'additionalProperties': {}}}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'continue_url': {'type': 'string'}}, 'additionalProperties': {}}
Modifié
cancel_checkout
5 October 2026 02:55
Modifié
complete_checkout
5 October 2026 02:55
Modifié
update_checkout
5 October 2026 02:55
Modifié
get_checkout
5 October 2026 02:55
Modifié
create_checkout
5 October 2026 02:55
Modifié
nota_simple_pedir
5 October 2026 02:55
Modifié
nota_simple_estado
5 October 2026 02:55
Modifié
notas_simples_listar
5 October 2026 02:55
Modifié
mi_cuenta
5 October 2026 02:55
Modifié
favoritos_quitar
5 October 2026 02:55
Modifié
favoritos_anadir
5 October 2026 02:55
Modifié
favoritos_listar
5 October 2026 02:55
Modifié
alertas_activar
5 October 2026 02:55
Modifié
alertas_eliminar
5 October 2026 02:55
Modifié
alertas_editar
5 October 2026 02:55
Modifié
alertas_crear
5 October 2026 02:55
Modifié
alertas_previsualizar
5 October 2026 02:55
Modifié
alertas_listar
5 October 2026 02:55
Modifié
mercado
5 October 2026 02:55
Modifié
recomendaciones
5 October 2026 02:55
Modifié
similares
5 October 2026 02:55
Modifié
informe
5 October 2026 02:55
Modifié
analisis_subasta
5 October 2026 02:55
Modifié
fetch
5 October 2026 02:55
Modifié
search
5 October 2026 02:55
Modifié
planes
5 October 2026 02:55
Modifié
explicar_concepto
5 October 2026 02:55
Modifié
estadisticas_publicas
5 October 2026 02:55
Modifié
resultados_recientes
5 October 2026 02:55
Modifié
buscar_por_codigo
5 October 2026 02:55