API docs by Redocly

Boston SAM Geocoder (1.0.1)

Download OpenAPI specification:

OpenAPI derived from the live service documentation at https://geocoder.boston.gov/samgeocoder. Field names, types, and examples follow the published endpoint docs.

Service index

HTML landing page with endpoint docs.

Responses

Geocode an address and enrich with SAM context

Returns a list of address matches. If no match, returns a single object with matching_address_full: "No matches found".

query Parameters
address
required
string

Address string; can be single-line or street-only.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Reverse geocode WGS84 XY and return nearest address/centerline/intersection + districts

Finds the nearest address and returns additional overlay context. All XY are WGS84 (SRID 4326).

query Parameters
x
required
number

Longitude (WGS84).

y
required
number

Latitude (WGS84).

Responses

Response samples

Content type
application/json
{
  • "nearest_address_full": "1 City Hall Plz, BOSTON, MA, 02114",
  • "nearest_address_street_number": "1",
  • "nearest_address_street_name": "City Hall Plz",
  • "nearest_address_unit": "",
  • "nearest_address_zip_code": "02114",
  • "nearest_address_x": -71.0582056,
  • "nearest_address_y": 42.3605989,
  • "nearest_address_distance_meters_from_input_xy": 7.2,
  • "nearest_address_sam_id": 1234567,
  • "nearest_address_primary_sam_id": 1234567,
  • "nearest_address_primary_sam_address": "1 City Hall Plz, BOSTON, MA, 02114",
  • "nearest_address_building_id": 987654,
  • "btd_district": 3,
  • "city_council_district": 1,
  • "fire_district": 1,
  • "mailing_neighborhood": "Downtown",
  • "nearest_centerline_street_jurisdiction": "Public Way",
  • "nearest_centerline_street_name": "City Hall Plz",
  • "nearest_centerline_street_ownership": "PWD",
  • "nearest_centerline_x": -71.05821,
  • "nearest_centerline_y": 42.3606,
  • "nearest_intersection_distance_meters_from_input_xy": 25.3,
  • "nearest_intersection_name": "Congress St & North St",
  • "nearest_intersection_x": -71.0569,
  • "nearest_intersection_y": 42.3619,
  • "parcel": "0301234000",
  • "park_name": "",
  • "park_ownership": "",
  • "planning_neighborhood": "Downtown",
  • "police_district": "A-1",
  • "pwd_district": "PWD-01",
  • "trash_day": "Mon",
  • "ward": "03",
  • "precinct": "03-01",
  • "zip_code": "02114"
}

Geocode a street intersection and enrich with SAM context

Input must contain " and " or " & ". Non-street results are filtered by the service. If no match, returns a single object with matching_intersection_full: "No matches found".

query Parameters
intersection
required
string

Intersection string (e.g., "Parmenter St and Hanover St").

Responses

Response samples

Content type
application/json
[
  • {
    }
]