# GET /api/v1/broadband/addresses

> Find the addresses Inleed can deliver fiber to

- Group: broadband
- Tier: R
- Required scope: read:orders
- Docs: https://api.inleed.com/reference/broadband/search-broadband-addresses

## Description

Returns `data[]` of buildings — each with its `id` (required by `get_broadband_offers`), `fullAddress`, city `network`, `deliverable`, the `downloadSpeeds` available and the cheapest monthly price — plus `parsed` (how the text was read) and `orderUrl`. `$actor` is accepted and ignored: the public tier calls the same Action with no Actor at all, and coverage data is identical for every caller.

## Query parameters

- `query` — string (required). The street address to look up, as the customer would write it: street name and house number, optionally with a postal code and city — "Lagmansvägen 12, 18163 Lidingö". A city or postal code alone will not identify an address.
- `network_id` — string. Up to 32 characters. Pattern ^[A-Za-z0-9_-]+$.
- `limit` — integer. Page size for a collection. Range 1–50.

## Request

```bash
curl -X GET "https://mcp.inleed.com/api/v1/broadband/addresses?query=example.se&network_id=res_01hx8n3k5p7q9r2s4t6v8w0y52&limit=3" \
  -H "Authorization: Bearer inl_live_…"
```

## Errors

- **400**  — codes: invalid_request
- **401** No token was presented, or the token is revoked, expired or unknown. — codes: unauthorized, token_expired, token_revoked
- **403** The token lacks a required scope, or this account does not own the resource. — codes: insufficient_scope, not_owned
- **404** No such resource for this account. — codes: not_found
- **422** Validation error — codes: validation_failed
- **429** The rate limit for this token is exhausted. See `Retry-After`. — codes: rate_limited
- **500** Something went wrong on our side. The failure is logged against `requestId`. — codes: internal_error

## Related

- GET /api/v1/broadband/addresses/{address}/offers — https://api.inleed.com/reference/broadband/get-broadband-offers