# Locations

**Provider:** Locations
**Category:** maps
**Base URL:** `https://sandbox.whapi.com/v2/locations`
**Auth:** oauth2 — `Authorization: Bearer YOUR_ACCESS_TOKEN`
**Rate Limit:** 4,000 API calls/min (authenticated)
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://sandbox.whapi.com/v2/locations

## Description

The Locations API is a collection of methods that support geographical information. The first method is an address lookup service for UK addresses. This service can be used to provide a new customer with a list of possible addresses from which they can populate a registration form.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://sandbox.whapi.com/v2/locations/address/lookup/` | Retrieves a list of addresses when supplied with a house number or name and a po |
| GET | `https://sandbox.whapi.com/v2/locations/countries/` | Retrieves a list of countries and its currencies. |
| GET | `https://sandbox.whapi.com/v2/locations/countries/{countryCode}` | Retrieves the specified country and its currency. |
| GET | `https://sandbox.whapi.com/v2/locations/currencies/` | Retreives the list of currencies. |
| GET | `https://sandbox.whapi.com/v2/locations/currencies/{currencyCode}` | Retreives the specified currency. |

## Authentication

OAuth 2.0 or JWT (Server Authentication) for machine-to-machine

```
Authorization: Bearer YOUR_ACCESS_TOKEN
```

## Sample Request

```bash
curl -X GET 'https://sandbox.whapi.com/v2/locations/address/lookup/' \
  -H 'apiKey: YOUR_API_KEY'
```

## Sample Response

```json
{}
```

## Pricing Details

Individual: free (10GB). Business Starter: $15/user/mo (unlimited storage). Business: $20/user/mo. Enterprise: custom.

---

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