# Geocoder REST API

**Provider:** Geocoder REST
**Category:** developer
**Base URL:** `https://geocoder.api.gov.bc.ca/`
**Auth:** api-key — `apikey: YOUR_API_KEY`
**Rate Limit:** Not officially published
**Free Tier:** Yes — available
**Pricing:** Enterprise / contact sales (subscription)
**Docs:** https://dpdd.atlassian.net/servicedesk/customer/portal/1/group/7/

## Description

This API represents address cleaning, correction, completion, geocoding, reverse geocoding, and proximity resources for intersection addresses, physical addresses and their occupants in British Columbia. Please read our [data collection notice](https://github.com/bcgov/api-specs/blob/master/COLLECTI

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://geocoder.api.gov.bc.ca//addresses.{outputFormat}` | Geocode an address |
| GET | `https://geocoder.api.gov.bc.ca//intersections/near.{outputFormat}` | Find intersections near to a geographic point |
| GET | `https://geocoder.api.gov.bc.ca//intersections/nearest.{outputFormat}` | Find nearest intersection to a geographic point |
| GET | `https://geocoder.api.gov.bc.ca//intersections/within.{outputFormat}` | Find intersections in a geographic area |
| GET | `https://geocoder.api.gov.bc.ca//intersections/{intersectionID}.{outputFormat}` | Get an intersection by its unique ID |
| GET | `https://geocoder.api.gov.bc.ca//occupants/addresses.{outputFormat}` | Geocode an address and identify site occupants |
| GET | `https://geocoder.api.gov.bc.ca//occupants/near.{outputFormat}` | Find occupants of sites near to a geographic point |
| GET | `https://geocoder.api.gov.bc.ca//occupants/nearest.{outputFormat}` | Find occupants of the site nearest to a geographic point |

## Authentication

API key in the request header (apikey)

```
apikey: YOUR_API_KEY
```

## Sample Request

```bash
curl -X GET 'https://geocoder.api.gov.bc.ca//addresses.{outputFormat}' \
  -H 'apikey: YOUR_API_KEY'
```

## Sample Response

```json
{}
```

## Pricing Details

Free with BC government API key. BC Data Catalogue geocoder for Canadian addresses.

---

*Source: [API Map](https://apimap.dev/apis/geocoder-rest/) — CC BY 4.0*