AuctionFlow DocsGet a key

    API Documentation

    Read-only REST API. JSON only. Versioned at /v1.

    Authentication

    All requests require a Bearer token. Get one from the dashboard.

    Authorization: Bearer ak_live_...

    Base URL

    https://uvxqztmszoyryaqgsqka.supabase.co/functions/v1/api

    Rate limits & quotas

    Every response includes:

    • X-RateLimit-Limit — your monthly quota
    • X-RateLimit-Remaining — requests left this month
    • X-RateLimit-Reset — unix timestamp when quota resets

    Exceeding quota returns 429 with an upgrade link.

    MCP server
    no key

    Prefer to let an AI assistant query auctions directly? BelowHammer runs a remote Model Context Protocol server — JSON-RPC 2.0 over Streamable HTTP, read-only, no API key required.

    https://belowhammer.com/mcp

    Tools: search_lots, get_lot, upcoming_auctions. Returns public listing facts only (address, guide price, auction date & house, property type, source link) — valuations and risk analysis stay on the signed-in site.

    Add it in Claude Desktop / Cursor via a remote MCP entry:

    {
  "mcpServers": {
    "belowhammer": {
      "type": "streamable-http",
      "url": "https://belowhammer.com/mcp"
    }
  }
}

    Endpoints

    GET
    /v1/me

    Returns your plan and remaining quota for the current month.

    curl -H "Authorization: Bearer ak_live_..." \
  "https://uvxqztmszoyryaqgsqka.supabase.co/functions/v1/api/v1/me"

    GET
    /v1/auctions

    Upcoming auction houses and dates with lot counts.

    curl -H "Authorization: Bearer ak_live_..." \
  "https://uvxqztmszoyryaqgsqka.supabase.co/functions/v1/api/v1/auctions"

    GET
    /v1/lots

    Paginated lots. Query params: region, max_price, property_type, auction_from, auction_to, limit (max 100), cursor.

    curl -H "Authorization: Bearer ak_live_..." \
  "https://uvxqztmszoyryaqgsqka.supabase.co/functions/v1/api/v1/lots?max_price=150000&limit=10"

    GET
    /v1/lots/{id}

    Single lot detail.

    curl -H "Authorization: Bearer ak_live_..." \
  "https://uvxqztmszoyryaqgsqka.supabase.co/functions/v1/api/v1/lots/<uuid>"

    GET
    /v1/search

    Free-text search over listing name and address.

    curl -H "Authorization: Bearer ak_live_..." \
  "https://uvxqztmszoyryaqgsqka.supabase.co/functions/v1/api/v1/search?q=manchester"

    For AI agents

    The API is fully described by an OpenAPI 3.1 document and an llms.txt manifest:

    Drop either URL into ChatGPT, Claude, or Cursor to give them tool access to UK auction data.