Data Retention Policy
How long Geocodio keeps your data, and how to delete it sooner
Quick summary
- API request logs: detailed logs are kept 14 to 46 days, then deleted. Only aggregated request counts remain after that.
- Spreadsheet uploads: automatically deleted after 6 weeks on Self-Serve, 72 hours on Enterprise.
- Maps: kept until explicitly deleted, along with the spreadsheet behind them.
- Delete anytime: spreadsheets can be removed from the dashboard before the automatic deletion window.
- Enterprise: API queries are never stored at all.
Retention at a glance
| Data type | Self-Serve | Enterprise |
|---|---|---|
| Detailed API logs (IP, User-Agent, query, appends) | 14–46 days | 14–46 days |
| API queries on single-address endpoint | Stored for up to 46 days | Never stored |
| Lists API requests | 72 hours | 72 hours |
| Spreadsheet uploads | 6 weeks | 72 hours |
| Spreadsheets turned into maps | Until deleted | Until deleted |
| Aggregated request counts | Retained | Retained |
| Custom shorter retention | Self-Serve Unlimited team admins | Configurable |
API Usage
For every API call made to Geocodio's geocoding API, we store the following data:
User-Agent Header
IP Address
Type of request
Query (single-address endpoint only, never on Enterprise)
Selected field appends
Performance metrics are stored alongside:
Accuracy metrics
HTTP response status code
Processing time
How the rollup works
On the 1st of each month, Geocodio rolls up the previous month's usage into aggregated totals. After rollup, only the number of requests per day per API key is kept. IP addresses, queries, and field appends are excluded from the aggregated record.
Detailed logs are deleted 14 days after rollup. That means detailed API usage is kept for as little as 14 days and no more than 46 days.
Lists API
Lists API results are automatically deleted 72 hours after processing has completed.
Spreadsheet Uploads
Self-Serve
Spreadsheet uploads are automatically deleted six weeks after upload, with two exceptions:
Maps: if a spreadsheet has been turned into a map, both the map and its underlying spreadsheet stay until explicitly deleted.
Earlier deletion: uploads can be deleted at any time from the dashboard.
Self-Serve Unlimited team admins can set a retention policy that deletes spreadsheets sooner than six weeks.
Enterprise
Spreadsheet uploads are automatically deleted 72 hours after processing completes.
If a spreadsheet has been turned into a map, both the map and its underlying spreadsheet stay until explicitly deleted.
Enterprise team admins have the ability to customize the data retention policy.
Deleting your data
Spreadsheet: delete from the dashboard at any time
Account: delete from the account settings at any time
Team-wide retention rules: Self-Serve Unlimited and Enterprise team admins can configure this in team settings
Related Resources
By the time you finish reading this page, the Geocodio API will have processed 5.3 million lookups.
Your data could be next...