{
 "openapi": "3.0.3",
 "info": {
  "title": "RentCheck SA",
  "version": "1.0.0",
  "description": "Pay-per-request rental & listing-integrity verification, SADC-first, agent-parseable. Fair-rent benchmarks, levy/utilities, fraud flags, relist/dupe detection. x402 v1, USDC Solana.",
  "contact": {
   "email": "michael.poncana@gmail.com"
  },
  "x-payment-info": {
   "scheme": "exact",
   "network": "solana",
   "asset": "USDC",
   "payTo": "CVWxHvN9MdWRGN6mEfDtUjmoypMtkTJX4mBRrhmhzKk2"
  }
 },
 "servers": [
  {
   "url": "https://rentcheck.themonexus.com"
  }
 ],
 "paths": {
  "/api/v1/rentcheck/rental/check": {
   "get": {
    "summary": "Fair-rent band + fraud flags for address/suburb",
    "x-payment-info": {
     "scheme": "exact",
     "network": "solana",
     "asset": "USDC",
     "maxAmountRequired": "0.01",
     "payTo": "CVWxHvN9MdWRGN6mEfDtUjmoypMtkTJX4mBRrhmhzKk2"
    },
    "security": [
     {
      "x402": []
     }
    ],
    "responses": {
     "402": {
      "description": "x402 payment required"
     },
     "200": {
      "description": "success",
      "content": {
       "application/json": {
        "schema": {
         "example": {
          "suburb": "Umhlanga",
          "fair_rent": {
           "low": 11500,
           "high": 16500
          },
          "source": "seed:public-listings-knowledge-2026-08",
          "as_of": "2026-08-07"
         }
        },
        "example": {
         "suburb": "Umhlanga",
         "fair_rent": {
          "low": 11500,
          "high": 16500
         },
         "source": "seed:public-listings-knowledge-2026-08",
         "as_of": "2026-08-07"
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/rentcheck/listing/verify": {
   "post": {
    "summary": "Listing integrity report (SSRF-guarded)",
    "x-payment-info": {
     "scheme": "exact",
     "network": "solana",
     "asset": "USDC",
     "maxAmountRequired": "0.02",
     "payTo": "CVWxHvN9MdWRGN6mEfDtUjmoypMtkTJX4mBRrhmhzKk2"
    },
    "security": [
     {
      "x402": []
     }
    ],
    "responses": {
     "402": {
      "description": "x402 payment required"
     },
     "200": {
      "description": "success",
      "content": {
       "application/json": {
        "schema": {
         "example": {
          "fraud_flags": [
           "dupe_hash"
          ],
          "dupe_of": "sha256:efef5678",
          "score": 0.82
         }
        },
        "example": {
         "fraud_flags": [
          "dupe_hash"
         ],
         "dupe_of": "sha256:efef5678",
         "score": 0.82
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/rentcheck/suburb/stats": {
   "get": {
    "summary": "Suburb benchmark stats",
    "x-payment-info": {
     "scheme": "exact",
     "network": "solana",
     "asset": "USDC",
     "maxAmountRequired": "0.005",
     "payTo": "CVWxHvN9MdWRGN6mEfDtUjmoypMtkTJX4mBRrhmhzKk2"
    },
    "security": [
     {
      "x402": []
     }
    ],
    "responses": {
     "402": {
      "description": "x402 payment required"
     },
     "200": {
      "description": "success",
      "content": {
       "application/json": {
        "schema": {
         "example": {
          "suburb": "Randburg",
          "listings": 124,
          "median_rent": 12500,
          "yoy_change": 0.04
         }
        },
        "example": {
         "suburb": "Randburg",
         "listings": 124,
         "median_rent": 12500,
         "yoy_change": 0.04
        }
       }
      }
     }
    }
   }
  },
  "/api/v1/rentcheck/pass": {
   "get": {
    "summary": "Pass purchase info",
    "x-payment-info": {
     "scheme": "exact",
     "network": "solana",
     "asset": "USDC",
     "maxAmountRequired": "0.00",
     "payTo": "CVWxHvN9MdWRGN6mEfDtUjmoypMtkTJX4mBRrhmhzKk2"
    },
    "security": [
     {
      "x402": []
     }
    ],
    "responses": {
     "402": {
      "description": "x402 payment required"
     },
     "200": {
      "description": "success",
      "content": {
       "application/json": {
        "schema": {
         "example": {
          "key": "rc_live_...",
          "expires": "2026-09-07",
          "tier": "desk"
         }
        },
        "example": {
         "key": "rc_live_...",
         "expires": "2026-09-07",
         "tier": "desk"
        }
       }
      }
     }
    }
   }
  }
 },
 "components": {
  "securitySchemes": {
   "x402": {
    "type": "apiKey",
    "in": "header",
    "name": "X-PAYMENT"
   }
  }
 }
}