Skip to content

API

One POST, one answer.

Send a boundary, get back ranked sites with depth, yield, confidence and the evidence behind each one. The same meter as the interface: land size decides the cost.

In private preview: reads are answered against your workspace token now, and starting a run from your own system is being opened with the first customers.

Ask for API accessSee the rate and your keys

Request

http
POST /v1/analyses
Authorization: Bearer $BENEATH_API_KEY

{
  "name": "Halverson Ranch",
  "optimization_mode": "BALANCED",
  "geometry": { "type": "Polygon", "coordinates": [[ ... ]] }
}

Result

json
{
  "type": "Feature",
  "geometry": { "type": "Point", "coordinates": [-120.3005, 36.178] },
  "properties": {
    "candidate_id": "0f2c…", "rank": 1, "label": "GW-001",
    "final_score": 0.91, "confidence": 0.82,
    "depth_p10": 78, "depth_p50": 87, "depth_p90": 96,
    "yield_p10": 12, "yield_p50": 15, "yield_p90": 19,
    "cost_low": 28500, "cost_high": 95000,
    "recommendation": "RECOMMENDED",
    "next_action": "Run a resistivity traverse before siting the rig."
  }
}

Endpoints

  • POST/api/v1/analysesStart an analysis from a GeoJSON boundary.
  • GET/api/v1/analysesThe analyses this workspace has run.
  • GET/api/v1/analyses/{analysis_id}State, boundary, and why a run ended.
  • GET/api/v1/analyses/{analysis_id}/candidatesRanked sites, as GeoJSON points.
  • GET/api/v1/analyses/{analysis_id}/cellsThe scored surface, as GeoJSON polygons.
  • GET/api/v1/candidates/{candidate_id}One site in full: forecasts and the evidence behind them.
  • POST/api/v1/candidates/{candidate_id}/drilling-outcomesReport what was actually drilled, and what was found.

What you get

  • REST API over your workspace's analyses
  • Keys issued with you, in private preview
  • OpenAPI schema, generated from the service
  • No uptime commitment while the API is in private preview
  • One flat rate, no volume discount

Pricing

$99/ month, 10 maps included

Every map after that
$19 per map
Past 250 maps / month
Talk to us

One rate at every volume. Analyses are licensed for use inside your own organisation. Reselling, white-labelling or redistributing a result needs a written agreement.