{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"1ed2aa9f-9a5d-4c20-bbe0-44ec9451361f","name":"wh","description":"# How to format requests for Parcels\n\nThere are 6 ways to make a request for a parcel:\n\n1. `parcel_id` this refers to Welcome's internal UUID for a parcel, and is a reliable way of retrieving the parcel record once you have the ID\n2. `lat` and `lon` note that different sources have different lat/lon for the given parcel, so if no parcel is found using these coordinates, please try a different request combination (i.e. `mls_code` and `mls_name`)\n3. `mls_code` and `mls_number` The `mls_code` returned from the `MultipleListingServices` endpoint for a given MLS, and its MLS Number\n4. `mls_name` and `mls_number` The `mls_name` returned from the `MultipleListingServices` endpoint, please make sure the name is formatted as shown in the `MultipleListingServices` response\n5. `tax_id` and `zip5`, note that `tax_id` may also be called parcel number sometimes, and `zip5` should be a 5 digit zip code.\n    \n6. `street_address`, `zip5`, and `state_abbr`, note: please don't include the city name in the street address, `state_abbr` refers to the two letter abbreviation of the state (e.g. \"NY\")\n    \n\n## **Parcels Response**\n\n```\n{\n  \"id\": \"c70a2d84-b178-4dda-bcc6-113e9d834f39\",\n  \"normalized_address\": \"1690 redd road georgia 30004\",\n  \"tax_id\": \"22 443007440916\",\n  \"status\": \"complete\",\n  \"buildable_models\": [\n    {\n      \"id\": \"04956041-146a-42b9-9ab8-4466c7c2ba5b\",\n      \"name\": \"Oasis 4 Grand\",\n      \"url\": \"https://welcomehomes.com/properties/c70a2d84-b178-4dda-bcc6-113e9d834f39?floor_plan_id=c6c524ce-5ab5-489e-9ec2-b82d536e60ba\",\n      \"land_prep_price_dollars\": 160360,\n      \"build_price_dollars\": 720300,\n      \"profile_image_url\": \"https://welcomehomes.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaEpJaWxqTVRZek5XRm1ZUzFtWXpCbUxUUXlNREV0WWpKaE9TMDNPVEZpTldRME5XWXdPREVHT2daRlZBPT0iLCJleHAiOm51bGwsInB1ciI6ImJsb2JfaWQifX0=--b836c0b11d1559325aea48a23c51301da650e422/Welcome-Oasis-4-Grand-Exterior-V01.jpg\"\n    },\n    ...\n  ]\n}\n\n ```\n\n`id` Refers to Welcome's internal UUID for the parcel\n\n`normalized_address` Welcome's formatted address for querying\n\n`tax_id` The parcel number or tax id assigned by local tax assessment offices\n\n`status` Refers to whether or not this parcel has reviewed for buildability, possible values are \"pending\" or \"complete\".\n\nA \"complete\" status with an empty `buildable_models` array means that the parcel is not buildable.\n\nA \"pending\" status with an empty `buildable_models` array means that it has not been reviewed yet, and will be reviewed within 24 hours of getting the API response. If you receive this result, please check back after 24 hours to see the determination of its buildability.\n\n`buildable_models` The Welcome home models that have been determined to fit on this parcel\n\n**Within** **`buildable_models`**\n\n`id` The Welcome internal UUID for home models\n\n`name` The name of the modesl\n\n`url` URL of the property page for the parcel and compatible floor plans\n\n`land_prep_price_dollars` Estimated cost of preparing the land for building, i.e. land clearing, driveway, etc.\n\n`build_price_dollars` Estimated construction cost of the house, which varies based on location, permitting fees, and other variables\n\n`profile_image_url` URL of the home model's profile image\n\n## Response Codes\n\n`200 OK` Indicates a parcel was successfully matched and returned\n\n`422 Unprocessable Content` Might mean that a required parameter was missing or formatted incorrectly for your query type\n\n`404 Not Found` Indicates no parcel was found matching the parameters sent\n\n`500 Server Error` Internal server error unrelated to your request","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"16137306","team":2010398,"collectionId":"1ed2aa9f-9a5d-4c20-bbe0-44ec9451361f","publishedId":"2s93sc4CZ2","public":true,"publicUrl":"https://developers.welcomehomes.com","privateUrl":"https://go.postman.co/documentation/16137306-1ed2aa9f-9a5d-4c20-bbe0-44ec9451361f","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FFFFFF"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/694b983e-afed-4395-b0e3-b93c7600b5d9/d2VsY29tZS1mYXZpY29uLTU1OC5wbmc=","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"ffffff"}},{"name":"light","logo":"https://content.pstmn.io/7fe04d91-c625-4329-b095-56fc0da660e1/ODU3MjFiMWUtMmU2NS00ZGNiLTk1ZmYtYTAxYzBlNGU0MTQ4X3RodW1iLmpwZw==","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FFFFFF"}}]}},"version":"8.10.0","publishDate":"2023-06-09T20:17:40.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/7fe04d91-c625-4329-b095-56fc0da660e1/ODU3MjFiMWUtMmU2NS00ZGNiLTk1ZmYtYTAxYzBlNGU0MTQ4X3RodW1iLmpwZw==","logoDark":"https://content.pstmn.io/694b983e-afed-4395-b0e3-b93c7600b5d9/d2VsY29tZS1mYXZpY29uLTU1OC5wbmc="}},"statusCode":200},"environments":[{"name":"Prod","id":"f00cfcd9-2997-4c33-9547-f5dc5865390a","owner":"26382688","values":[{"key":"base_url","value":"https://welcomehomes.com","enabled":true,"type":"default"},{"key":"auth_token","value":"","enabled":true,"type":"secret"},{"key":"frances_test_token","value":"0b4ed94710d0020fcc359165731b4dadf6a571d424e722c6b03271b6cd739839","enabled":true}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/0c08d0447c06bb0903a5c65cc64d388143825ed1ec3b8fe39ee08b7e54883f2a","favicon":"https://welcomehomes.com/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Prod","value":"26382688-f00cfcd9-2997-4c33-9547-f5dc5865390a"}],"canonicalUrl":"https://developers.welcomehomes.com/view/metadata/2s93sc4CZ2"}