Nearby Doctor API

Request parameters

Requests include:

• User location — latitude and longitude for proximity-based ranking
• Search string — optional partial name for autocomplete matching
• Max results — number of results to return (default 50)
• Authentication token — Firebase ID token for access control

Response data

Each result includes:

• First name, last name, and full display name
• Honorific and professional title
• Practice information: street address, city, state, ZIP code
• Practice location: latitude and longitude

Example response

{
  "results": [
    {
      "firstName": "Jane",
      "lastName": "Smith",
      "fullName": "Dr. Jane Smith, MD",
      "honorific": "Dr.",
      "title": "MD",
      "address": "123 Medical Center Dr",
      "city": "Redwood City",
      "state": "CA",
      "zip": "94063",
      "latitude": 37.4852,
      "longitude": -122.2364
    },
    {
      "firstName": "John",
      "lastName": "Smithson",
      "fullName": "Dr. John Smithson, DO",
      "honorific": "Dr.",
      "title": "DO",
      "address": "456 Health Blvd",
      "city": "Palo Alto",
      "state": "CA",
      "zip": "94301",
      "latitude": 37.4419,
      "longitude": -122.143
    }
  ]
}

API specification

The full API specification is available as an OpenAPI document (YAML format).

Database

The API is backed by a database of over 6 million licensed medical professionals in the United States, sourced from the National Plan and Provider Enumeration System (NPPES). The database is updated periodically.

Contact

For API access, integration support, or questions, contact [email protected].