Menu

# Geocodio API Reference for LLMs Geocodio is a geocoding and data enrichment API for US, Canadian, and Mexican addresses. It converts addresses to coordinates (and vice versa), calculates distances, and appends data like Census information, Congressional districts, and timezones. **Not a developer?** You can also upload spreadsheets directly at https://www.geocod.io/upload/ — no coding required. ## Quick Reference - **Base URL:** `https://api.geocod.io/v1.10/` - **OpenAPI Spec (JSON):** https://api.geocod.io/openapi-spec.json - **OpenAPI Spec (YAML):** https://api.geocod.io/openapi-spec.yml - **Full Documentation:** https://www.geocod.io/docs/ - **Dashboard (API keys):** https://dash.geocod.io --- ## Quick Start **Base URL:** `https://api.geocod.io/v1.10/` All requests require `&api_key=YOUR_API_KEY` ### Geocoding | Task | Method | Endpoint | Example | |------|--------|----------|---------| | Geocode address | GET | /geocode?q={address} | `?q=1600+Pennsylvania+Ave+NW+DC` | | Reverse geocode | GET | /reverse?q={lat,lng} | `?q=38.9,-77.0` | | Batch geocode (up to 10k) | POST | /geocode | Body: `["address1", "address2"]` | | Batch reverse (up to 10k) | POST | /reverse | Body: `["lat1,lng1", "lat2,lng2"]` | ### Lists API (Spreadsheet Processing) | Task | Method | Endpoint | Notes | |------|--------|----------|-------| | Upload spreadsheet | POST | /lists | Multipart form: `file`, `direction`, `format` | | Check status | GET | /lists/{id} | Returns `status.state`: PROCESSING or COMPLETED | | Download results | GET | /lists/{id}/download | Returns CSV (follow redirects) | | List all | GET | /lists | Paginated | | Delete | DELETE | /lists/{id} | Auto-deletes after 72 hours anyway | ### Distance API | Task | Method | Endpoint | Max Size | |------|--------|----------|----------| | Single origin | GET | /distance?origin={o}&destinations[]={d} | 100 destinations | | Distance matrix | POST | /distance-matrix | 10,000 calculations | | Create async job | POST | /