Zippopotam.us (ZIP Code API)

api.zippopotam.us · Location

Location No Auth Free & Open Geocoding ZIP Codes Location

ZIP code lookup for 60+ countries — get city, state, latitude, and longitude from a postal code. Free, no API key required.

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET Look up US ZIP code

Get city and state for Beverly Hills ZIP code 90210.

https://api.zippopotam.us/us/90210

Hover any highlighted part to learn what it does

curl -X GET "https://api.zippopotam.us/us/90210"

import requests
response = requests.get(
    "https://api.zippopotam.us/us/90210",
)
print(response.json())

const url = 'https://api.zippopotam.us/us/90210';

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.zippopotam.us/us/90210"
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.zippopotam.us/us/90210")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.zippopotam.us/us/90210";
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET UK postcode

Get location data for UK postcode SW1A (Westminster).

https://api.zippopotam.us/gb/sw1a

Hover any highlighted part to learn what it does

curl -X GET "https://api.zippopotam.us/gb/sw1a"

import requests
response = requests.get(
    "https://api.zippopotam.us/gb/sw1a",
)
print(response.json())

const url = 'https://api.zippopotam.us/gb/sw1a';

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.zippopotam.us/gb/sw1a"
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.zippopotam.us/gb/sw1a")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.zippopotam.us/gb/sw1a";
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

No API key needed
US: GET https://api.zippopotam.us/us/10001 (New York)
UK: GET https://api.zippopotam.us/gb/ec1a
Canada: GET https://api.zippopotam.us/ca/m5v
Format: /{country_code}/{postal_code}

What can you build with Zippopotam.us (ZIP Code API)?

Zippopotam.us (ZIP Code API) is a Location API. Developers commonly use location APIs for:

tracking assets and vehicles in real time
building delivery and logistics apps
finding nearby businesses or services
geo-fencing and location-based notifications
address validation and autocomplete

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Zippopotam.us (ZIP Code API) is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide

Open documentation ↗