Developer API · v1

Pull your operator data programmatically.
REST · JSON · Bearer auth.

Operators on Landlock can integrate their public profile, deal flow, well status, and active offers directly into their IPM/CRM (Quorum, P2, OGsys, Enertia, custom). One API key. No SDK required. cURL-friendly.

1. Get your API key

Issue a key for any operator

During the open beta, any operator on the Leaderboard can issue an API key directly. Production gates this behind admin verification + Cloudflare Access.

Operator ID
Label (for your records)
2. Test it instantly

cURL the operator endpoint

Returns operator metadata, last 50 deals, all wells, and active offers — same data the public Leaderboard sees.

Bearer token

Endpoints

Authentication

All v1 endpoints require an Authorization: Bearer <your_api_key> header. Keys are SHA-256 hashed in storage and shown once on issuance — store securely.

GET/api/v1/operator/me

Returns the calling operator's full public profile, recent deals, wells, and active offers.

Headers
Authorization: Bearer lmop_…
Response
{ ok, operator, recent_deals[], wells[], active_offers[], rate_limit }
# Example curl https://www.landmanx.ai/api/v1/operator/me \ -H "Authorization: Bearer lmop_YOUR_KEY"

Public read-only data (no key required)

For owner-facing tools and aggregators, the entire database is exposed read-only without auth.

GET/api/leaderboard — operator FDS rankings + tier distribution
GET/api/operators — all operator metadata
GET/api/operators/:id — operator + deals + wells
GET/api/tracts / /api/tracts/:id
GET/api/wells?operator=ID&tract=ID
GET/api/comps?basin=Permian&days=90
GET/api/coalitions / /api/coalitions/:id
GET/api/well-history?api=42-329-44188
GET/api/cron — daily ingestion run history

Write endpoints (form-driven, no key required during beta)

POST/api/signup — owner/operator signups
POST/api/tracts/submit — owner submits a tract for review
POST/api/coalitions/join — join an existing coalition
POST/api/coach — AI Negotiation Coach (Llama 3.3 70B via Workers AI)
POST/api/auth/magic-link — owner login

Rate limits

During public beta: unmetered. Production limits will be enforced per-key (proposed: 1,000 req/hr per operator key, 100/hr unauthenticated). Returns X-RateLimit-Remaining headers.

Webhooks (coming next)

Subscribe to events: offer.received, offer.countered, lease.signed, well.production_change, fds.recalculated. POST your webhook URL to /api/v1/operator/webhooks (TODO).

Need direct SQL or schema docs?

Inspect the live database schema and every record at /tracts. Email dev@landmanx.ai for production access, custom rate limits, or webhook integration.