{"uid":"cap_6CzctyP0LeAz9C8Zz17oS","slug":"proppulse-first-time-homebuyer-guide-40a19071","name":"PropPulse First-Time Homebuyer Guide","description":"First-time homebuyer down-payment-assistance finder: every DPA grant and program, eligible loan types (FHA, VA, USDA, conventional), max home price, closing-cost estimate, and step-by-step process for any US state. For homebuyer and real-estate agents.","url":"https://proppulse-gules.vercel.app/api/prop/first-buyer","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"zip":{"type":"string","description":"legacy alias for location, implies country=US"},"lang":{"type":"string","description":"en | es | fr | de | zh | pt | ar"},"credit":{"type":"string"},"income":{"type":"string"},"country":{"type":"string","description":"US | UK | CA | DE | AU | IN (optional)"},"savings":{"type":"string"},"location":{"type":"string","description":"Denver, CO | Manchester | Toronto"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"max_home_price":380000,"down_payment_options":[{"down":19000,"program":"Conventional 5% down"},{"down":13300,"program":"FHA 3.5% down"}],"first_buyer_programs":["Colorado CHFA — 3% down + $25K grant"],"closing_costs_estimate":9500}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4gtTKmTglLQ9jNBJQqDP8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a comprehensive first-time homebuyer guide covering assistance programs, loan types, and step-by-step purchase process for a specified state","exampleAgentPrompt":"I'm thinking about buying my first home in Colorado — can you pull up the PropPulse first-time homebuyer guide for Colorado and show me all the assistance programs, loan types available, and the step-by-step process I need to follow?","exampleUseCases":null,"resultDescription":"A structured guide covering: all available first-time homebuyer assistance programs (state and federal grants, down payment assistance, tax credits), eligible loan types (FHA, VA, USDA, conventional), and a step-by-step walkthrough of the home purchase process tailored to the specified state.","failureModes":["Missing or invalid state parameter returns an error or generic result","State has no specific programs — returns federal-only programs","Payment of 0.1 USDC required; failure to pay results in 402 Payment Required","Rate limiting may occur with excessive calls","Data may be out of date if state programs have changed recently"],"whenToPreferThis":"Use this endpoint when a user explicitly identifies as a first-time homebuyer and needs guidance on programs, loan eligibility, and the purchase process for a specific U.S. state. Prefer this over general mortgage or affordability endpoints when the user needs assistance programs and process guidance rather than rate quotes or property valuations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:48:34.370Z","isFirstParty":false}