---
title: "Search for a list of addresses"
method: GET
path: "/addresses"
tags: ["address"]
---

# Search for a list of addresses

`GET /addresses`

returns a list of addresses matching the search string

## Query parameters

- `q` string, required

## Response `200`

successful query

- object[] — The list of addresses matching the search string. The list may be paginated. A the `Link` header with a `rel` of `next` will be provided if there are additional results.
  - `sla` string, required — The full address flattened to a single line. The primary use is for search results and for autocomplete.
  - `ssla` string — The full address flattened to a single line. The primary use is for search results and for autocomplete.
  - `highlight` object
    - `sla` string, required — The full address flattened to a single line with matching search tokens highlighted
    - `ssla` string — The full address flattened to a single line with matching search tokens highlighted
  - `score` number, required — strength of the match relative to the other matches
  - `pid` string, required — The Persistent Identifier is unique to the real world feature this record represents.

## Other responses

- `400` — invalid query
- `500` — unexpected error
- `503` — service unavailable

---

[API](https://skmtc.net/mountain-pass/apis/addressr-by-mountain-pass.md) · [All operations](https://skmtc.net/mountain-pass/apis/addressr-by-mountain-pass/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mountain-pass/addressr-by-mountain-pass/versions/4a4c43b9b253/schema)