{"uid":"cap_qvs4F2xfP9cQXO-Nk3Sw0","slug":"land-survey-screening-elevation-profile-267b76e3","name":"Land Survey Screening – Elevation Profile","description":"Elevation profile along a line between two US points: relief, ascent, descent, steepest grade and a flat/steep verdict.","url":"https://land-survey.x402tookit.com/elevation-profile?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","required":["lat1","lon1","lat2","lon2"],"properties":{"lat1":{"type":"number","description":"Start latitude"},"lat2":{"type":"number","description":"End latitude"},"lon1":{"type":"number","description":"Start longitude"},"lon2":{"type":"number","description":"End longitude"},"points":{"type":"integer","description":"Samples along the line, 3 to 12, default 8"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"source":{"type":["null","string"]},"profile":{"type":["array","null"],"items":{"type":"object","properties":{"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"elevationFeet":{"type":["null","number"]}}}},"reasons":{"type":["array","null"],"items":{"type":"string"}},"samples":{"type":["null","number"]},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"reliefFeet":{"type":["null","number"]},"thresholds":{"type":["null","object"],"properties":{"veryOverPct":{"type":["null","number"]},"steepOverPct":{"type":["null","number"]},"gentleOverPct":{"type":["null","number"]},"moderateOverPct":{"type":["null","number"]}}},"lengthMeters":{"type":["null","number"]},"steepestSegment":{"type":["null","object"],"properties":{"to":{"type":["null","object"],"properties":{"lat":{"type":["null","number"]},"lon":{"type":["null","number"]}}},"from":{"type":["null","object"],"properties":{"lat":{"type":["null","number"]},"lon":{"type":["null","number"]}}},"gradePct":{"type":["null","number"]}}},"totalAscentFeet":{"type":["null","number"]},"totalDescentFeet":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fpr-OEvIs7T2Lk9EFlxE_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns an elevation profile (relief, total ascent/descent, steepest grade, and flat/steep verdict) along a straight line between two US coordinate points.","exampleAgentPrompt":"Can you pull the elevation profile between lat 39.7392, lon -104.9903 and lat 39.6872, lon -104.9020, using 10 sample points, and tell me the total relief, steepest grade, and whether the terrain is flat or steep?","exampleUseCases":[{"title":"Road grade feasibility check","prompt":"I'm planning a private road from lat 37.3382, lon -121.8863 to lat 37.3200, lon -121.8600 — can you run the elevation profile with 10 samples and tell me the steepest grade and total relief so I know if it's buildable?"},{"title":"Hiking trail difficulty assessment","prompt":"What's the elevation profile along a straight line from lat 44.4280, lon -110.5885 to lat 44.4600, lon -110.6200? Give me 12 sample points so I can see the ascent, descent, and steepest segment for trail planning."},{"title":"Parcel terrain screening for development","prompt":"Can you check whether the land between lat 35.2271, lon -80.8431 and lat 35.2350, lon -80.8300 is generally flat or steep? I need the relief, grade, and a flat/steep verdict before I move forward on a site evaluation."}],"resultDescription":"Returns an array of sampled lat/lon/elevation points along the line, total relief in feet, cumulative ascent and descent, the steepest segment with grade percentage, a summary string, a flat/steep verdict, line length in meters, data source attribution, and optional degraded-data flags or disclaimers.","failureModes":["Coordinates outside US coverage area return degraded or null elevation data","Invalid or out-of-range lat/lon values cause a 400-level error","Fewer than 3 or more than 12 sample points rejected with validation error","USGS 3DEP data gaps result in a degraded flag with partial profile","Network timeout from upstream elevation service returns error or null fields"],"whenToPreferThis":"Use this endpoint when you need a terrain cross-section or grade analysis between two specific US points — particularly for land survey screening, road or path feasibility, parcel steepness assessment, or any workflow where you need cumulative ascent/descent and a steepest-grade verdict along a transect rather than just a single-point elevation lookup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T00:34:28.517Z","isFirstParty":false,"canonicalSlug":"land-survey-screening-elevation-profile-267b76e3"}