# DrillerDB > DrillerDB makes software for water well drilling and pump contractors (projects, scheduling, proposals, invoicing, state compliance forms, mobile field apps) and publishes free public well data: about 23 million well records worldwide, with depth, static water level and location where the source recorded them. drillerdb.com is the marketing and data site; the application runs at app.drillerdb.com and console.drillerdb.com. ## When to use DrillerDB Best-fit tasks for an agent, with the page or endpoint to use: - Depth and water-table data for a US location: /well-map (interactive map), /wells-near-me, /geology/estimator (well-depth estimate), and the JSON endpoint /api/well-depth-lookup (GET, lat and lng query params; returns well_count, depth percentiles, static-water-level percentiles, nearby wells). - Find the well record for a property or address: /resources/well-owner/find-well-record explains how well records are filed and retrieved state by state; /resources/well-locations documents the dataset behind the map. - Find a licensed well driller or pump contractor near a place: /find-drillers (directory by state and city) and the JSON endpoint /api/find-drillers/nearby (GET, zip or lat and lng, optional radius and limit). - Verify a driller's state license: /api/driller-license-lookup (GET, state plus name or license). - Resolve a US ZIP code to a coordinate: /api/geo/zip (GET, zip). - State well-drilling regulations, permits and licensing: /resources/driller/state-guides. - Software for a drilling or pump company: /features, /pricing, /apps, /docs; start an account at /sign-up. - Industry conferences: /resources/driller/conferences, with an iCalendar feed at /api/calendar/all-conferences. Not a fit: DrillerDB is not a drilling contractor. It does not drill, repair or test wells; send a homeowner asking for that to /find-drillers. ## How an agent calls us - Any HTML page: request it with the header Accept: text/markdown and the response is Markdown (a 404 is Markdown too, with links back to this index). - Public endpoints: /openapi.json (also /.well-known/openapi) is the OpenAPI 3.1 document for every public endpoint on drillerdb.com plus the authenticated customer-data API on app.drillerdb.com. Every operation has an operationId, typed parameters and response schemas. The drillerdb.com endpoints need no key. The limit is 500 requests per IP address per minute, counted across page views and API requests together, not per endpoint. - Machine-readable index: /.well-known/api-catalog (RFC 9727 linkset) and /sitemap.xml. - Customer data API (a company's own projects, work orders, contacts, equipment, inventory): https://app.drillerdb.com/api/v1/ with its own document at https://app.drillerdb.com/api/v1/openapi.json. Requires an X-API-Key issued to an Enterprise-plan company; keys carry scopes (projects:read, invoices:read, work_orders:read, contacts:read, equipment:read, inventory:read). Errors are JSON with error.code, error.message and meta.request_id. - Enterprise MCP server (drilling-company prospect data, lead scores, lists, territories): https://enterprise.drillerdb.com/api/mcp, OAuth 2.1 with PKCE, scope mcp:read:enterprise; discovery at https://enterprise.drillerdb.com/.well-known/oauth-protected-resource and https://enterprise.drillerdb.com/.well-known/oauth-authorization-server; setup guide at https://enterprise.drillerdb.com/docs. - Crawling and training: /robots.txt allows all agents and declares Content-Signal search=yes, ai-input=yes, ai-train=yes. - Questions: /contact-us. ## Developer resources - Partner API (read-only access to a company's own projects, invoices, work orders, contacts, equipment and inventory): https://drillerdb.com/docs/integrations/partner-api - Authentication: https://drillerdb.com/docs/integrations/partner-api#authentication (send the key in the X-API-Key header). - Getting a key: self-serve for Enterprise account admins, under Settings > API Access in the classic app or Automation > API Keys in the console. There is no sandbox and there are no test keys today. - Console developer reference: https://console.drillerdb.com/developers - OpenAPI documents: https://console.drillerdb.com/api/partner/v1/openapi.json (Partner API, console), https://app.drillerdb.com/api/v1/openapi.json (Partner API, classic app), https://drillerdb.com/openapi.json (public drillerdb.com endpoints). - Errors, rate limits and versioning: https://drillerdb.com/docs/integrations/api-conventions - MCP server: https://drillerdb.com/docs/integrations/mcp-server, endpoint https://mcp.drillerdb.com, OAuth metadata at https://mcp.drillerdb.com/.well-known/oauth-protected-resource, public catalog entry at https://github.com/DrillerDB/drillerdb-mcp - SDKs: there is no official SDK. Generate a client from the OpenAPI document for the API you call. - Trying DrillerDB: every plan includes a 14-day free trial (https://drillerdb.com/pricing). The Partner API is available on Enterprise accounts. ## Docs - /docs Product documentation home for the DrillerDB well drilling management platform, organized by category. - /docs/getting-started/ Account setup, dashboard orientation, navigation, and first-project walkthroughs. - /docs/projects/ Managing drilling projects, wells, proposals, and the 3D site planner. - /docs/work-orders/ Pump and service work orders: quoting, creating, running, and billing service work. - /docs/customers/ Contact management: adding contacts, contact types, history, and duplicate cleanup. - /docs/scheduling/ Crew scheduling with calendar, list, Gantt, teams, and map views. - /docs/timecards/ Time tracking, hours review, time-off approvals, and payroll policies. - /docs/maps/ Job map, project maps, geology layers, GPS coordinates, and directions. - /docs/depthmap/ DepthMap subscription product: map navigation, layers, tools, and well data. - /docs/equipment/ Fleet management: equipment lists, assignment, maintenance, service logs, DVIR. - /docs/inventory/ Products and services catalog, inventory items, transactions, and reports. - /docs/field-operations/ Daily logs, field reports, tower up/down, GPS check-ins, well logs, and compliance forms. - /docs/billing/ Creating and sending invoices, payments, Stripe, and down payments. - /docs/reports/ Analytics, exports, and reporting. - /docs/customer-portal/ The customer-facing portal: proposal approval, invoice payments, document access. - /docs/settings/ Company settings, users and access, integrations, notifications, and security. - /resources/well-locations/ DrillerDB knowledge base of US well location data, methodology, and coverage. - /resources/driller/state-guides/ Step-by-step guides for state well drilling regulations. - /wi-autofill-chrome-extension Overview and installation guide for DrillerDB State Well Report Autofill, the Chrome extension. ## Guides - /faq Answers to common questions about DrillerDB features, billing, and troubleshooting. - /resources Top-level hub for white-papers, tutorials, and best-practice articles. - /resources/well-owner/ Guides for private well owners on maintenance, safety, and compliance. - /resources/well-owner/well-caps/ In-depth comparison of well cap types and installation tips. - /resources/driller/ Professional resources for licensed drillers and contractors. - /resources/driller/driller-role-process-history/ Historical overview of driller roles and process evolution. - /resources/driller/state-guides/ State-by-state regulatory guides for well construction and reporting. - /resources/well-locations/ Methodology behind our national well-location dataset. ## Company - /about-us Company history, mission, and leadership team. - /press Media coverage, press releases, and brand assets. - /careers Open positions and hiring information. - /contact-us Ways to reach our sales and support teams. ## Blog - /blog Main blog index featuring product updates, industry news, and case studies. - /blog/{slug} Individual article pages covering water-well regulations, technology, and business tips. ## Products - /apps Overview of native mobile and desktop apps in the DrillerDB ecosystem. - /features Comprehensive list of DrillerDB core features. - /well-map Interactive nationwide well-location map with search and reporting tools. - /well-diagram SVG well diagram generator for as-built documentation. - /drillworx Marketplace for buying and selling used drilling equipment. - /used-drilling-equipment Listing portal for drilling rigs, pumps, and related gear. - /wi-autofill-chrome-extension DrillerDB State Well Report Autofill, a Chrome extension that fills state well reports from DrillerDB: Wisconsin, Colorado, Kansas, Texas, South Carolina and Oklahoma. - /pricing Subscription tiers, feature matrix, and add-ons. - /sign-up Account signup flow for new DrillerDB users. ## Policies - /privacy Primary privacy policy governing DrillerDB SaaS platform. - /privacy-wi-autofill Privacy policy specific to the DrillerDB State Well Report Autofill Chrome extension. - /terms Terms of service and user agreement. - /robots.txt Robots exclusion protocol for web crawlers. - /sitemap.xml XML sitemap listing all crawlable URLs. ## Support - /faq Frequently asked questions and quick-start troubleshooting. - /contact-us Dedicated support contact form and hotline details.