{"openapi":"3.1.0","info":{"title":"RentCast via Locus x402","version":"1.0.0","description":"US real estate intelligence — property records, AVM valuations, rent estimates, sale/rental listings, and market statistics.","contact":{"email":"api@paywithlocus.com"},"x-guidance":"Use the documented POST operations for RentCast. Send JSON matching each requestBody schema. Unpaid public x402 requests return an x402 v2 payment challenge; retry the same body with PAYMENT-SIGNATURE and the returned x-locus-request-id."},"servers":[{"url":"https://rentcast.x402.paywithlocus.com"}],"x-agentcash-guidance":{"llmsTxtUrl":"https://paywithlocus.com/x402/rentcast.md"},"x-service-info":{"categories":["data"],"docs":{"homepage":"https://rentcast.io","apiReference":"https://developers.rentcast.io/reference/introduction","llms":"https://paywithlocus.com/x402/rentcast.md"}},"paths":{"/rentcast/properties":{"post":{"operationId":"rentcast_properties","summary":"Property Records","description":"Search property records by location. Returns ownership, tax history, features, and transaction history for 140M+ US properties.","tags":["Data / Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.033000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.033"}},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","description":"Full address (Street, City, State, Zip)"},"city":{"type":"string","description":"City name (case-sensitive)"},"state":{"type":"string","description":"2-character state abbreviation"},"zipCode":{"type":"string","description":"5-digit US zip code"},"latitude":{"type":"number","description":"Latitude for circular search"},"longitude":{"type":"number","description":"Longitude for circular search"},"radius":{"type":"number","description":"Search radius in miles (max 100)"},"propertyType":{"type":"string","description":"Single Family, Condo, Townhouse, Manufactured, Multi-Family, Apartment, Land (pipe-separated for multiple)"},"bedrooms":{"type":"string","description":"Number of bedrooms. Supports ranges (1:3) and multiples (1|3)"},"bathrooms":{"type":"string","description":"Number of bathrooms. Supports ranges and multiples"},"squareFootage":{"type":"string","description":"Living area in sq ft. Supports ranges/multiples"},"lotSize":{"type":"string","description":"Lot size in sq ft. Supports ranges/multiples"},"yearBuilt":{"type":"string","description":"Year built. Supports ranges/multiples"},"saleDateRange":{"type":"string","description":"Days since last sale (min 1). Supports ranges"},"limit":{"type":"number","description":"Max records to return (1-500, default 50)"},"offset":{"type":"number","description":"Pagination offset (default 0)"},"includeTotalCount":{"type":"boolean","description":"Include total count in X-Total-Count response header"}},"allOf":[{"description":"At least one location parameter is required: address, city, state, zipCode, latitude, or longitude","anyOf":[{"required":["address"]},{"required":["city"]},{"required":["state"]},{"required":["zipCode"]},{"required":["latitude"]},{"required":["longitude"]}]}],"additionalProperties":true},"example":{"address":"5500 Grand Lake Dr, San Antonio, TX 78244","limit":1}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"city":{"type":"string"}}},"description":"Partial response schema observed in an authenticated, semantically verified customer call. Only observed field types are described; optionality, other inputs and error states are not inferred."},"request":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"statusUrl":{"type":"string"}},"required":["id","statusUrl"],"additionalProperties":false},"payment":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact","upto"]},"authorizedMaxUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"settledUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"capExhausted":{"type":"boolean"},"calculatedActualUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"usage":{}},"required":["scheme","authorizedMaxUsdc","settledUsdc"],"additionalProperties":false}},"required":["success","data","request","payment"],"additionalProperties":false}}}},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/rentcast/property-by-id":{"post":{"operationId":"rentcast_property_by_id","summary":"Property by ID","description":"Retrieve a single property record by its RentCast ID.","tags":["Data / Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.033000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.033"}},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"RentCast property ID (e.g., \"5500-Grand-Lake-Dr,-San-Antonio,-TX-78244\")"}},"required":["id"],"additionalProperties":true},"example":{"id":"5500-Grand-Lake-Dr,-San-Antonio,-TX-78244"}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"formattedAddress":{"type":"string"}},"description":"Partial response schema observed in an authenticated, semantically verified customer call. Only observed field types are described; optionality, other inputs and error states are not inferred."},"request":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"statusUrl":{"type":"string"}},"required":["id","statusUrl"],"additionalProperties":false},"payment":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact","upto"]},"authorizedMaxUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"settledUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"capExhausted":{"type":"boolean"},"calculatedActualUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"usage":{}},"required":["scheme","authorizedMaxUsdc","settledUsdc"],"additionalProperties":false}},"required":["success","data","request","payment"],"additionalProperties":false}}}},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/rentcast/random-properties":{"post":{"operationId":"rentcast_random_properties","summary":"Random Properties","description":"Get randomly selected property records. Useful for testing and sampling.","tags":["Data / Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.033000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.033"}},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"number","description":"Number of records (1-500, default 5)"}},"additionalProperties":true},"example":{"limit":1}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"}}},"description":"Partial response schema observed in an authenticated, semantically verified customer call. Only observed field types are described; optionality, other inputs and error states are not inferred."},"request":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"statusUrl":{"type":"string"}},"required":["id","statusUrl"],"additionalProperties":false},"payment":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact","upto"]},"authorizedMaxUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"settledUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"capExhausted":{"type":"boolean"},"calculatedActualUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"usage":{}},"required":["scheme","authorizedMaxUsdc","settledUsdc"],"additionalProperties":false}},"required":["success","data","request","payment"],"additionalProperties":false}}}},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/rentcast/value-estimate":{"post":{"operationId":"rentcast_value_estimate","summary":"Value Estimate (AVM)","description":"Get an automated property valuation with comparable sale listings. Returns price estimate, confidence range, and comparable properties.","tags":["Data / Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.033000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.033"}},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","description":"Full property address"},"latitude":{"type":"number","description":"Property latitude"},"longitude":{"type":"number","description":"Property longitude"},"propertyType":{"type":"string","description":"Single Family, Condo, Townhouse, Manufactured, Multi-Family, Apartment, Land"},"bedrooms":{"type":"number","description":"Number of bedrooms (0 = studio)"},"bathrooms":{"type":"number","description":"Number of bathrooms"},"squareFootage":{"type":"number","description":"Living area in sq ft"},"maxRadius":{"type":"number","description":"Max distance to comparable properties in miles"},"daysOld":{"type":"number","description":"Max age of comparable listings in days"},"compCount":{"type":"number","description":"Number of comparables to return (5-25, default 15)"}},"allOf":[{"description":"Either address or latitude+longitude is required","anyOf":[{"required":["address"]},{"required":["latitude","longitude"]}]}],"additionalProperties":true},"example":{"address":"5500 Grand Lake Dr, San Antonio, TX 78244","propertyType":"Single Family","bedrooms":3,"bathrooms":2,"squareFootage":1800,"compCount":5}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"object","additionalProperties":true,"properties":{"comparables":{"type":"array","items":{"type":"object","additionalProperties":true}},"price":{"type":"number"}},"description":"Partial response schema observed in an authenticated, semantically verified customer call. Only observed field types are described; optionality, other inputs and error states are not inferred."},"request":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"statusUrl":{"type":"string"}},"required":["id","statusUrl"],"additionalProperties":false},"payment":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact","upto"]},"authorizedMaxUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"settledUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"capExhausted":{"type":"boolean"},"calculatedActualUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"usage":{}},"required":["scheme","authorizedMaxUsdc","settledUsdc"],"additionalProperties":false}},"required":["success","data","request","payment"],"additionalProperties":false}}}},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/rentcast/rent-estimate":{"post":{"operationId":"rentcast_rent_estimate","summary":"Rent Estimate","description":"Get a long-term rental estimate with comparable rental listings. Returns monthly rent estimate, range, and comparables.","tags":["Data / Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.033000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.033"}},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","description":"Full property address"},"latitude":{"type":"number","description":"Property latitude"},"longitude":{"type":"number","description":"Property longitude"},"propertyType":{"type":"string","description":"Single Family, Condo, Townhouse, Manufactured, Multi-Family, Apartment, Land"},"bedrooms":{"type":"number","description":"Number of bedrooms (0 = studio)"},"bathrooms":{"type":"number","description":"Number of bathrooms"},"squareFootage":{"type":"number","description":"Living area in sq ft"},"maxRadius":{"type":"number","description":"Max distance to comparable properties in miles"},"daysOld":{"type":"number","description":"Max age of comparable listings in days"},"compCount":{"type":"number","description":"Number of comparables to return (5-25, default 15)"}},"allOf":[{"description":"Either address or latitude+longitude is required","anyOf":[{"required":["address"]},{"required":["latitude","longitude"]}]}],"additionalProperties":true},"example":{"address":"5500 Grand Lake Dr, San Antonio, TX 78244","propertyType":"Single Family","bedrooms":3,"bathrooms":2,"squareFootage":1800,"compCount":5}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"object","additionalProperties":true,"properties":{"comparables":{"type":"array","items":{"type":"object","additionalProperties":true}},"rent":{"type":"number"}},"description":"Partial response schema observed in an authenticated, semantically verified customer call. Only observed field types are described; optionality, other inputs and error states are not inferred."},"request":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"statusUrl":{"type":"string"}},"required":["id","statusUrl"],"additionalProperties":false},"payment":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact","upto"]},"authorizedMaxUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"settledUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"capExhausted":{"type":"boolean"},"calculatedActualUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"usage":{}},"required":["scheme","authorizedMaxUsdc","settledUsdc"],"additionalProperties":false}},"required":["success","data","request","payment"],"additionalProperties":false}}}},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/rentcast/sale-listings":{"post":{"operationId":"rentcast_sale_listings","summary":"Sale Listings","description":"Search for-sale property listings by location. Returns MLS data, agent info, pricing, and listing history.","tags":["Data / Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.033000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.033"}},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","description":"Full address (Street, City, State, Zip)"},"city":{"type":"string","description":"City name (case-sensitive)"},"state":{"type":"string","description":"2-character state abbreviation"},"zipCode":{"type":"string","description":"5-digit US zip code"},"latitude":{"type":"number","description":"Latitude for circular search"},"longitude":{"type":"number","description":"Longitude for circular search"},"radius":{"type":"number","description":"Search radius in miles (max 100)"},"propertyType":{"type":"string","description":"Single Family, Condo, Townhouse, Manufactured, Multi-Family, Apartment, Land (pipe-separated for multiple)"},"bedrooms":{"type":"string","description":"Number of bedrooms. Supports ranges (1:3) and multiples (1|3)"},"bathrooms":{"type":"string","description":"Number of bathrooms. Supports ranges and multiples"},"squareFootage":{"type":"string","description":"Living area in sq ft. Supports ranges/multiples"},"lotSize":{"type":"string","description":"Lot size in sq ft. Supports ranges/multiples"},"yearBuilt":{"type":"string","description":"Year built. Supports ranges/multiples"},"status":{"type":"string","description":"Active or Inactive (default: Active)"},"price":{"type":"string","description":"Listed price filter. Supports ranges/multiples"},"daysOld":{"type":"string","description":"Days on market (min 1). Supports ranges"},"limit":{"type":"number","description":"Max records to return (1-500, default 50)"},"offset":{"type":"number","description":"Pagination offset (default 0)"},"includeTotalCount":{"type":"boolean","description":"Include total count in X-Total-Count response header"}},"allOf":[{"description":"At least one location parameter is required: address, city, state, zipCode, latitude, or longitude","anyOf":[{"required":["address"]},{"required":["city"]},{"required":["state"]},{"required":["zipCode"]},{"required":["latitude"]},{"required":["longitude"]}]}],"additionalProperties":true},"example":{"city":"San Francisco","state":"CA","limit":1}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"}}},"description":"Partial response schema observed in an authenticated, semantically verified customer call. Only observed field types are described; optionality, other inputs and error states are not inferred."},"request":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"statusUrl":{"type":"string"}},"required":["id","statusUrl"],"additionalProperties":false},"payment":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact","upto"]},"authorizedMaxUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"settledUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"capExhausted":{"type":"boolean"},"calculatedActualUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"usage":{}},"required":["scheme","authorizedMaxUsdc","settledUsdc"],"additionalProperties":false}},"required":["success","data","request","payment"],"additionalProperties":false}}}},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/rentcast/sale-listing-by-id":{"post":{"operationId":"rentcast_sale_listing_by_id","summary":"Sale Listing by ID","description":"Retrieve a single for-sale listing by its ID.","tags":["Data / Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.033000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.033"}},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Sale listing ID"}},"required":["id"],"additionalProperties":true},"example":{"id":"<from rentcast/sale-listings>"}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"formattedAddress":{"type":"string"}},"description":"Partial response schema observed in an authenticated, semantically verified customer call. Only observed field types are described; optionality, other inputs and error states are not inferred."},"request":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"statusUrl":{"type":"string"}},"required":["id","statusUrl"],"additionalProperties":false},"payment":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact","upto"]},"authorizedMaxUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"settledUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"capExhausted":{"type":"boolean"},"calculatedActualUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"usage":{}},"required":["scheme","authorizedMaxUsdc","settledUsdc"],"additionalProperties":false}},"required":["success","data","request","payment"],"additionalProperties":false}}}},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/rentcast/rental-listings":{"post":{"operationId":"rentcast_rental_listings","summary":"Rental Listings","description":"Search long-term rental listings by location. Returns MLS data, agent info, pricing, and listing history.","tags":["Data / Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.033000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.033"}},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","description":"Full address (Street, City, State, Zip)"},"city":{"type":"string","description":"City name (case-sensitive)"},"state":{"type":"string","description":"2-character state abbreviation"},"zipCode":{"type":"string","description":"5-digit US zip code"},"latitude":{"type":"number","description":"Latitude for circular search"},"longitude":{"type":"number","description":"Longitude for circular search"},"radius":{"type":"number","description":"Search radius in miles (max 100)"},"propertyType":{"type":"string","description":"Single Family, Condo, Townhouse, Manufactured, Multi-Family, Apartment, Land (pipe-separated for multiple)"},"bedrooms":{"type":"string","description":"Number of bedrooms. Supports ranges (1:3) and multiples (1|3)"},"bathrooms":{"type":"string","description":"Number of bathrooms. Supports ranges and multiples"},"squareFootage":{"type":"string","description":"Living area in sq ft. Supports ranges/multiples"},"lotSize":{"type":"string","description":"Lot size in sq ft. Supports ranges/multiples"},"yearBuilt":{"type":"string","description":"Year built. Supports ranges/multiples"},"status":{"type":"string","description":"Active or Inactive (default: Active)"},"price":{"type":"string","description":"Rental price filter. Supports ranges/multiples"},"daysOld":{"type":"string","description":"Days on market (min 1). Supports ranges"},"limit":{"type":"number","description":"Max records to return (1-500, default 50)"},"offset":{"type":"number","description":"Pagination offset (default 0)"},"includeTotalCount":{"type":"boolean","description":"Include total count in X-Total-Count response header"}},"allOf":[{"description":"At least one location parameter is required: address, city, state, zipCode, latitude, or longitude","anyOf":[{"required":["address"]},{"required":["city"]},{"required":["state"]},{"required":["zipCode"]},{"required":["latitude"]},{"required":["longitude"]}]}],"additionalProperties":true},"example":{"city":"San Francisco","state":"CA","limit":1}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"}}},"description":"Partial response schema observed in an authenticated, semantically verified customer call. Only observed field types are described; optionality, other inputs and error states are not inferred."},"request":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"statusUrl":{"type":"string"}},"required":["id","statusUrl"],"additionalProperties":false},"payment":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact","upto"]},"authorizedMaxUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"settledUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"capExhausted":{"type":"boolean"},"calculatedActualUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"usage":{}},"required":["scheme","authorizedMaxUsdc","settledUsdc"],"additionalProperties":false}},"required":["success","data","request","payment"],"additionalProperties":false}}}},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/rentcast/rental-listing-by-id":{"post":{"operationId":"rentcast_rental_listing_by_id","summary":"Rental Listing by ID","description":"Retrieve a single long-term rental listing by its ID.","tags":["Data / Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.033000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.033"}},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Rental listing ID"}},"required":["id"],"additionalProperties":true},"example":{"id":"<from rentcast/rental-listings>"}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"formattedAddress":{"type":"string"}},"description":"Partial response schema observed in an authenticated, semantically verified customer call. Only observed field types are described; optionality, other inputs and error states are not inferred."},"request":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"statusUrl":{"type":"string"}},"required":["id","statusUrl"],"additionalProperties":false},"payment":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact","upto"]},"authorizedMaxUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"settledUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"capExhausted":{"type":"boolean"},"calculatedActualUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"usage":{}},"required":["scheme","authorizedMaxUsdc","settledUsdc"],"additionalProperties":false}},"required":["success","data","request","payment"],"additionalProperties":false}}}},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}},"/rentcast/markets":{"post":{"operationId":"rentcast_markets","summary":"Market Statistics","description":"Aggregate sale and rental market data for a US zip code — median prices, days on market, inventory, and monthly history across 38K+ zip codes.","tags":["Data / Intelligence"],"security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.033000"},"protocols":[{"x402":{}}],"x-locus":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","scheme":"exact","estimatedCost":"$0.033"}},"parameters":[{"name":"x-locus-request-id","in":"header","required":false,"description":"UUID returned by the initial 402. Echo it on the paid retry and later recovery attempts.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"zipCode":{"type":"string","description":"5-digit US zip code"},"dataType":{"type":"string","description":"\"Sale\", \"Rental\", or \"All\" (default: All)"},"historyRange":{"type":"number","description":"Months of historical data to return (default: 12)"}},"required":["zipCode"],"additionalProperties":true},"example":{"zipCode":"94043","dataType":"All","historyRange":12}}}},"responses":{"200":{"description":"Successful response with PAYMENT-RESPONSE and durable request receipt","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{"type":"object","additionalProperties":true,"properties":{"zipCode":{"type":"string"}},"description":"Partial response schema observed in an authenticated, semantically verified customer call. Only observed field types are described; optionality, other inputs and error states are not inferred."},"request":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"statusUrl":{"type":"string"}},"required":["id","statusUrl"],"additionalProperties":false},"payment":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact","upto"]},"authorizedMaxUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"settledUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"capExhausted":{"type":"boolean"},"calculatedActualUsdc":{"type":"string","pattern":"^\\d+\\.\\d{6}$"},"usage":{}},"required":["scheme","authorizedMaxUsdc","settledUsdc"],"additionalProperties":false}},"required":["success","data","request","payment"],"additionalProperties":false}}}},"202":{"description":"The supplied request ID is already in progress"},"400":{"description":"Invalid request"},"402":{"description":"Payment Required"},"409":{"description":"Request ID conflict or terminal failed request"}}}}}}