---
title: "Well drilling and pump companies near a location"
method: GET
path: "/api/find-drillers/nearby"
tags: ["Driller directory"]
---

# Well drilling and pump companies near a location

`GET /api/find-drillers/nearby`

## Request

- Base URL: `https://drillerdb.com`
- URL: `https://drillerdb.com/api/find-drillers/nearby`
- Auth: none declared

Public directory of well drilling and pump service companies. Give a ZIP code or a lat/lng to get companies within the radius, sorted by relevance with distance_miles filled in; give no location to get a national list sorted by quality. Only public directory fields are returned. Public, no key; the ZIP branch is rate limited per IP.

## Query parameters

- `zip` string
- `lat` number
- `lng` number
- `radius` number
- `limit` integer
- `trade` 'water_well' | 'geothermal' | 'environmental'

## Response `200`

Companies near the location (or the national list). Empty when the directory backend is unavailable.

- NearbyDrillersResponse
  - `companies` DirectoryCompany[], required
    - `id` union, required
      - integer
      - string
    - `name` string, required
    - `company_name` string
    - `phone` string
    - `slug` string: Directory profile: https://drillerdb.com/contractor/{slug}.
    - `city` string
    - `state` string
    - `zip` string
    - `latitude` number
    - `longitude` number
    - `distance_miles` number: Present when a location was given.
    - `distanceMiles` number
    - `is_featured` union
      - boolean
      - integer
    - `is_claimed` union
      - boolean
      - integer
    - `company_id` union
      - integer
      - string
    - `logo` string
    - `service_categories` unknown[]
      - unknown
    - `recent_wells` integer
    - `trade` 'water_well' | 'geothermal' | 'environmental': The category the directory lists the company under: water well, geothermal or environmental drilling.
    - `google_rating` union: Average Google rating; the directory backend may serve it as a decimal string (e.g. "4.8").
      - number
      - string
    - `google_review_count` integer

## Other responses

- `400`: zip is not five digits.
- `404`: The ZIP code is not known.
- `429`: Too many requests from this IP address. Wait the number of seconds in Retry-After.
- `503`: The ZIP geocoder is temporarily unavailable.

---

[API](https://skmtc.dev/drillerdb/apis/drillerdb-public-apis.md) · [All operations](https://skmtc.dev/drillerdb/apis/drillerdb-public-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/drillerdb/apis/drillerdb-public-apis/revisions/aeb372774d99?raw)