specification: FinOps Framework
specificationVersion: '1.0'
schema: https://www.finops.org/framework/
provider: Geocodio
providerId: geocodio
created: '2026-06-21'
modified: '2026-06-21'
reconciled: true
tags:
- Geocoding
- Reverse Geocoding
- Addresses
- Data Append
- Census
- FinOps
- Cost Management
- FOCUS
description: >-
  FinOps view of Geocodio spend. Geocodio bills usage-based per-lookup rates
  at $1 per 1,000 lookups after a daily free allowance of 2,500 lookups. Each
  requested data append field counts as an additional lookup, so enrichment
  multiplies cost. Flex subscriptions bundle rolling credits at a discount and
  the Unlimited plan provides a flat-rate dedicated instance.
notes: >-
  Per-lookup and subscription rates are subject to change; verify against the
  Geocodio pricing page during reconciliation.
sources:
- https://www.geocod.io/pricing/
- https://www.geocod.io/docs/
- https://focus.finops.org/focus-specification/v1-3/
alignedWith:
  framework: FinOps Foundation Framework
  frameworkUrl: https://www.finops.org/framework/
  dataSpec: FOCUS
  dataSpecVersion: '1.3'
  dataSpecUrl: https://focus.finops.org/focus-specification/v1-3/
publisherName: Geocodio
serviceCategory: Maps and Geospatial
billingModel:
  pricingCategory: Usage-Based
  billingFrequency: Monthly
  billingCurrency: USD
  chargeCategories:
  - Usage
  - Purchase
  - Adjustment
focusColumns:
  ServiceName: Geocodio
  ServiceCategory: Maps and Geospatial
  ProviderName: Geocodio
  PublisherName: Geocodio
  InvoiceIssuerName: Geocodio
  BillingCurrency: USD
  ChargeCategory: Usage
  PricingCategory: Usage-Based
meters:
- name: lookups
  description: Geocoding and reverse geocoding lookups billed at $1 per 1,000 after the daily free allowance.
  unit: lookups
  aggregation: sum
  dimensions:
  - account
  - api
- name: field_append_lookups
  description: Data append fields, each counting as one additional lookup per record.
  unit: lookups
  aggregation: sum
  dimensions:
  - account
  - field
- name: flex_credits
  description: Rolling monthly credits consumed under a Flex subscription plan.
  unit: credits
  aggregation: sum
  dimensions:
  - account
  - plan
- name: list_records
  description: Records processed through asynchronous spreadsheet list jobs.
  unit: records
  aggregation: sum
  dimensions:
  - account
  - list
principles:
- name: Visibility
  description: Pull Geocodio account usage; inspect daily lookup burn and free-allowance consumption.
- name: Allocation
  description: Tag API keys per workload/team; map metered lookups to internal cost centers.
- name: Optimization
  description: Stay within the 2,500/day free allowance where possible; request only the data append fields you need since each field doubles per-record cost; use Flex bundles or Unlimited for predictable high volume.
- name: Accountability
  description: Assign owners per project/key; review monthly lookup spend against budget and free-tier headroom.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com