---
title: "Get List of Addresses"
method: GET
path: "/addresses"
tags: ["address"]
---

# Get List of Addresses

`GET /addresses`

returns a list of addresses matching the search string

## Query parameters

- `q` string, required
- `p` integer

## 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.
  - `score` number, required — strength of the match relative to the other matches
  - `links` object, required
    - `self` object, required
      - `href` string, required — The URL for the address, where additional information can be retrieved

## 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/revisions/6217bf13b26e/schema)