# API Reference - Ideal Postcodes

**Provider:** API Reference - Ideal Postcodes
**Category:** maps
**Base URL:** `https://api.ideal-postcodes.co.uk/v1`
**Auth:** none — `# No auth required`
**Rate Limit:** See documentation
**Free Tier:** Yes — available
**Pricing:** Enterprise / contact sales (subscription)
**Docs:** https://ideal-postcodes.co.uk/support

## Description

Getting Started

Overview

Access

All API methods are either a GET, POST or OPTIONS request.

The API communicates over both HTTPS and plain HTTP using IPv4 and IPv6.

We recommend using HTTPS only although HTTP is available.

We use appropriate HTTP status codes where possible to in

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.ideal-postcodes.co.uk/v1/addresses` | Extract Addresses |
| GET | `https://api.ideal-postcodes.co.uk/v1/autocomplete/addresses` | Find Address |
| GET | `https://api.ideal-postcodes.co.uk/v1/autocomplete/addresses/{address}/gbr` | Resolve Address (GBR) |
| GET | `https://api.ideal-postcodes.co.uk/v1/autocomplete/addresses/{address}/usa` | Resolve Address (USA) |
| POST | `https://api.ideal-postcodes.co.uk/v1/cleanse/addresses` | Cleanse |
| GET | `https://api.ideal-postcodes.co.uk/v1/emails` | Email Validation |
| GET | `https://api.ideal-postcodes.co.uk/v1/keys/{key}` | Availability |
| GET | `https://api.ideal-postcodes.co.uk/v1/keys/{key}/configs` | List |

## Authentication

No authentication required

```
# No auth required
```

## Sample Request

```bash
curl -X GET 'https://api.ideal-postcodes.co.uk/v1/addresses' \
  -H '# No auth required'
```

## Sample Response

```json
{}
```

## Pricing Details

Free — open public API, no authentication required.

---

*Source: [API Map](https://apimap.dev/apis/api-reference-ideal-postcodes/) — CC BY 4.0*