Spain's property foreclosures, as clean JSON in one call

Judicial, notarial and tax-agency auctions from Spain's official portal subastas.boe.es, consolidated with legal thresholds already computed. For real-estate investors, PropTech and AI agents.

Start free on RapidAPI Connect to Claude / Cursor 
GET /auctions/SUB-JA-2026-260225

{
  "general": {
    "auctionType": "JUDICIAL EN VÍA DE APREMIO",
    "endDate": "2026-06-25T18:00:00+02:00",
    "appraisalValue": 267000,
    "reference70": 186900,
    "reference50": 133500,
    "deposit": 13350,
    "applicableThreshold": {
      "value": 186900,
      "basis": "reference70",
      "note": "Primary residence: 70% (art. 671 LEC)"
    }
  },
  "authority": { "name": "Sección Civil TI Granollers…" },
  "lots": [ { "assets": [ { "locality": "GRANOLLERS", … } ] } ],
  "bids": { "totalBids": 0, "requiresDeposit": true }
}

The official portal, without the pain

Spain's BOE publishes every auction split across four separate tabs, with no official API. This API does the consolidation and adds the analysis layer investors actually need.

⚖️ Applicable legal threshold

50% and 70% reference values computed, and for judicial auctions, which one applies under art. 671 LEC (primary residence yes/no, as published by the BOE itself).

📦 Per-lot financials

In multi-lot auctions each lot carries its own value, deposit and thresholds — exactly as the BOE structures them.

🛡️ GDPR by default

Spanish ID numbers and IBANs are redacted automatically before every response.

⚡ Fast and considerate

In-memory cache with short TTL: typical cached responses under 100 ms, and one single request to the BOE per search regardless of how many clients ask.

🔍 Auditable code

The source code is public on GitHub (non-commercial license): you can see exactly what is extracted and how.

📄 Official data

Source: the public portal of Spain's Official State Gazette. Orientative — always verify with a registry extract before bidding.

Your AI agent, connected to Spanish auctions

The backend ships an MCP (Model Context Protocol) server: Claude, Cursor or any compatible agent can search auctions, fetch consolidated detail and compute thresholds directly from context — literally ask "find flats in Barcelona ending this week".

// claude_desktop_config.json
{
  "mcpServers": {
    "subastas-boe": {
      "command": "node",
      "args": ["/path/to/subastas-boe-api/src/mcp/server.js"]
    }
  }
}

Available tools: search_auctions · get_auction_detail · calculate_auction_metrics · list_provinces

Pricing

Subscriptions are managed through RapidAPI: sign up in a minute with your account, no sales calls.

PlanPriceRequests/monthBest for
Free$0100Testing the API and integrations
Starter$9.90/mo500Individual investor, single-province alerts
Pro$29.90/mo2,000Active multi-province monitoring
Business$89/mo10,000PropTech, law firms, dashboards

No lock-in. Hard monthly quotas: when you run out, requests pause — never surprise overage charges.

Frequently asked questions

How can I get Spanish judicial auction (BOE) data as JSON?

The official portal has no API. This API extracts and consolidates each auction (general data, authority, per-lot assets and bids) into one JSON object, via REST or from an AI agent via MCP.

Which threshold applies, 50% or 70%?

With no bidders, art. 671 of the Spanish Civil Procedure Act sets it based on whether the asset is the debtor's primary residence: 70% if it is, 50% otherwise. The API flags the applicable one. Orientative, not legal advice.

How fresh is the data?

Fetched on demand and cached 2-4 hours. Auctions run for weeks — plenty fresh for monitoring and alerts.

Can I connect it to Claude or another AI agent?

Yes: it ships an MCP server with search, consolidated detail and threshold tools, compatible with Claude Desktop, Cursor and any MCP client.