MCP-Server

Subastech — subastas judiciales de inmuebles (BOE)

com.subastech/subastas-judiciales
Recht & Compliance Immobilien Suche & Recherche Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

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
Eingabeschema
{'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}
Ausgabeschema
{'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`.
Eingabeschema
{'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}
Ausgabeschema
{'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
Eingabeschema
{'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}
Ausgabeschema
{'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`).
Destruktiv Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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`.
Nur Lesen Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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'], '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.
Nur Lesen Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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'], '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`).
Nur Lesen Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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'], '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.
Nur Lesen Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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'], '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'].
Destruktiv Idempotent
Eingabeschema
{'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': {}}}}
Ausgabeschema
{'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
Eingabeschema
{'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': {}}}}
Ausgabeschema
{'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).
Eingabeschema
{'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': {}}}}
Ausgabeschema
{'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).
Nur Lesen Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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
Eingabeschema
{'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}
Ausgabeschema
{'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`.
Nur Lesen Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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'], '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`).
Destruktiv Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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`.
Nur Lesen Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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).
Nur Lesen Idempotent
Eingabeschema
{'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': {}}}}
Ausgabeschema
{'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`).
Nur Lesen Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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'], '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`.
Nur Lesen Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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`).
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
Ausgabeschema
{'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`).
Nur Lesen Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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.
Externer Zugriff Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
Ausgabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
Ausgabeschema
{'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'], '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.
Nur Lesen Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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'], '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.
Nur Lesen Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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`).
Nur Lesen Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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'], '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'], '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`.
Nur Lesen Idempotent
Eingabeschema
{'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}
Ausgabeschema
{'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'], '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'], '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
Eingabeschema
{'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': {}}}}
Ausgabeschema
{'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': {}}
Hinzugefügt
cancel_checkout
17. September 2026 12:37
Hinzugefügt
complete_checkout
17. September 2026 12:37
Hinzugefügt
update_checkout
17. September 2026 12:37
Hinzugefügt
get_checkout
17. September 2026 12:37
Hinzugefügt
create_checkout
17. September 2026 12:37
Hinzugefügt
nota_simple_pedir
17. September 2026 12:37
Hinzugefügt
nota_simple_estado
17. September 2026 12:37
Hinzugefügt
notas_simples_listar
17. September 2026 12:37
Hinzugefügt
mi_cuenta
17. September 2026 12:37
Hinzugefügt
favoritos_quitar
17. September 2026 12:37
Hinzugefügt
favoritos_anadir
17. September 2026 12:37
Hinzugefügt
favoritos_listar
17. September 2026 12:37
Hinzugefügt
alertas_activar
17. September 2026 12:37
Hinzugefügt
alertas_eliminar
17. September 2026 12:37
Hinzugefügt
alertas_editar
17. September 2026 12:37
Hinzugefügt
alertas_crear
17. September 2026 12:37
Hinzugefügt
alertas_previsualizar
17. September 2026 12:37
Hinzugefügt
alertas_listar
17. September 2026 12:37
Hinzugefügt
mercado
17. September 2026 12:37
Hinzugefügt
recomendaciones
17. September 2026 12:37
Hinzugefügt
similares
17. September 2026 12:37
Hinzugefügt
informe
17. September 2026 12:37
Hinzugefügt
analisis_subasta
17. September 2026 12:37
Hinzugefügt
fetch
17. September 2026 12:37
Hinzugefügt
search
17. September 2026 12:37
Hinzugefügt
planes
17. September 2026 12:37
Hinzugefügt
explicar_concepto
17. September 2026 12:37
Hinzugefügt
estadisticas_publicas
17. September 2026 12:37
Hinzugefügt
resultados_recientes
17. September 2026 12:37
Hinzugefügt
buscar_por_codigo
17. September 2026 12:37