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, and it is returned on the response.

Get a sandbox keyOpen developer portal

Request

http
POST /v1/analyses
Authorization: Bearer $BENEATH_API_KEY

{
  "name": "Halverson Ranch",
  "objective": "best_overall",
  "boundary": { "type": "Polygon", "coordinates": [[ ... ]] },
  "webhook_url": "https://example.com/hooks/beneath"
}

Result

json
{
  "id": "an_7Kq2f",
  "status": "complete",
  "area_km2": 18.4,
  "maps_charged": 1,
  "candidates": [
    {
      "rank": 1,
      "lng": -119.7858, "lat": 36.0525,
      "opportunity": 0.91, "confidence": 0.82,
      "depth_m":  { "p10": 78, "p90": 96 },
      "yield_m3h": { "p10": 12, "p90": 19 },
      "evidence": [
        { "id": "E-110", "direction": "supports", "weight": 0.90,
          "source": "California DWR, Well Completion Report database" }
      ]
    }
  ]
}

Endpoints

  • POST/v1/analysesStart an analysis from a GeoJSON boundary.
  • GET/v1/analyses/{id}Fetch status, candidates and evidence.
  • GET/v1/analyses/{id}/surfaceThe scored surface as GeoJSON.
  • GET/v1/analyses/{id}/reportThe field report as a PDF.
  • GET/v1/usageMaps consumed this cycle and the current rate.

What you get

  • REST API and signed webhooks
  • Developer portal with keys and usage
  • Free sandbox environment
  • OpenAPI schema and typed SDKs
  • 99.9% uptime target
  • 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.