> ## Documentation Index
> Fetch the complete documentation index at: https://docs.northaxiumdata.ca/llms.txt
> Use this file to discover all available pages before exploring further.

# Property Intelligence

> Research Edmonton property assessments, calculated taxes, characteristics, permits, zoning, and source evidence.

Property Intelligence connects municipal property records to one stable property identity. Search returns ranked candidates so you can confirm the correct property before requesting its history.

Edmonton is the first supported city. The live dataset includes assessment history from 2012 through 2025, current property characteristics, published tax rates, calculated tax estimates from 2014 through 2025, confirmed permit relationships, zoning, and source provenance.

<Warning>
  Property tax values are estimates calculated from published assessment values and municipal and education tax rates. They are not tax bills. Sales and comparable endpoints return records only after a licensed source explicitly permits display and analytics; no eligible Edmonton feed is active yet.
</Warning>

## REST workflow

All endpoints require your NorthAxium Data API key in the `X-API-Key` header.

| Step | Endpoint                                               | Purpose                                                     |
| ---- | ------------------------------------------------------ | ----------------------------------------------------------- |
| 1    | `GET /api/v1/properties/search`                        | Find ranked candidates by address or assessment account.    |
| 2    | `GET /api/v1/properties/{property_id}`                 | Get current facts, coverage, relationships, and provenance. |
| 3    | `GET /api/v1/properties/{property_id}/assessments`     | Get annual assessment history.                              |
| 4    | `GET /api/v1/properties/{property_id}/taxes`           | Get calculated property-tax history.                        |
| 5    | `GET /api/v1/properties/{property_id}/characteristics` | Get building and lot observations.                          |
| 6    | `GET /api/v1/properties/{property_id}/permits`         | Get confirmed permits; candidate links are opt-in.          |
| 7    | `GET /api/v1/properties/{property_id}/zoning`          | Get confirmed zoning assignments.                           |
| 8    | `GET /api/v1/properties/{property_id}/sources`         | Inspect publisher, licence, retrieval, and source evidence. |
| 9    | `GET /api/v1/properties/{property_id}/sales`           | Get licensed, display-approved transaction history.         |
| 10   | `GET /api/v1/properties/{property_id}/comparables`     | Get rights-approved nearby sale research candidates.        |

## Search example

```bash theme={null}
curl "https://api.northaxiumdata.ca/api/v1/properties/search?q=18230%20107A%20STREET%20NW&municipality=edmonton&province=AB" \
  -H "X-API-Key: <your-api-key>"
```

Use the returned `property_id` for the detail and history endpoints.

```bash theme={null}
curl "https://api.northaxiumdata.ca/api/v1/properties/<property_id>/assessments" \
  -H "X-API-Key: <your-api-key>"
```

## MCP workflow

The hosted MCP server exposes the same property workflow through ten read-only tools. Start with `search_properties`, then pass the selected `property_id` to the detail or history tools.

See [MCP Server](/model-context-protocol) for OAuth setup in ChatGPT, Claude, or Cursor.

## Data interpretation

* Assessment history is authoritative municipal source data.
* Tax rates are authoritative published rates; property-level tax amounts are calculated estimates.
* Confirmed permit links require a unique exact-address match. Candidate spatial links are excluded unless you explicitly request them.
* Zoning assignments use strict point-in-polygon matching.
* Each response reports coverage and source provenance so missing fields are distinguishable from zero values.
* Sale records require a source with display rights. Comparable selection additionally requires analytics rights, excludes known non-arm's-length sales, and reports its radius, time window, and ranking method.
* Comparable results support research only and are not an appraisal or automated valuation.