GEOREFER
GEOREFER is the only API that combines French address validation and company lookup in a single service. Address Validation - 26 million French addresses from the Base Adresse Nationale (BAN) - GeoTrust confidence score (0-100) with street-level matching - House number verification - AFNOR NF Z 10-011 postal address formatting - GPS coordinates for validated addresses Company Lookup (SIRENE) -…
2 subscribers
30 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
GEOREFER endpoints
| Method | Endpoint | Description |
|---|---|---|
| Address Validation | ||
| POST |
normalizeAddress /geographical_repository/v1/addresses/normalize |
Normalizes a French postal address according to AFNOR NF Z 10-011 / La Poste standards. Applies uppercase, accent removal, progressive abbreviation, and 38-char line limits. Full… |
| GET |
suggestAddresses /geographical_repository/v1/addresses/suggest |
Returns street name suggestions from BAN (Base Adresse Nationale) for autocomplete. Optionally filter by postal_code or city. Without filters, returns top streets from all… |
| POST |
validateAddress /geographical_repository/v1/addresses/validate |
Validates a postal address for KYC/AML compliance. Performs country verification, postal code matching, and confidence scoring. |
| Cities | ||
| GET |
fuzzySearch /geographical_repository/v1/cities/search |
Full-text city search with optional fuzzy matching for typo tolerance. Uses a multi-layer strategy: exact match (boost 3.0), fuzzy match with Levenshtein distance (boost 1.5),… |
| GET |
getCities /geographical_repository/v1/cities |
Search for cities/towns matching the given criteria with support for pagination. Can search by name, postal code, or INSEE code. INSEE code takes priority when provided. |
| GET |
autocomplete /geographical_repository/v1/cities/autocomplete |
Typeahead/autocomplete endpoint using Elasticsearch completion suggest. Returns rich suggestions with label, display, coordinates, and population. Falls back to PostgreSQL if… |
| City Enrichment | ||
| GET |
getEnrichment /geographical_repository/v1/cities/{insee_code}/enrichment |
Returns comprehensive geographical, demographic, and socioeconomic data for a French commune |
| GET |
getStatistics /geographical_repository/v1/cities/statistics |
Returns aggregated statistics and distributions across all enriched cities |
| Companies | ||
| GET |
searchCompanies /geographical_repository/v1/companies/search |
Full-text company name search with optional geographic and activity filters. Searches both registered company name (raison sociale) and trade name (enseigne). Results are… |
| GET |
getEstablishmentDetail /geographical_repository/v1/companies/{siret} |
Returns comprehensive details for a specific establishment identified by its SIRET number. |
| GET |
getCompanies /geographical_repository/v1/companies |
Lookup establishments by SIREN (9 digits, returns all establishments), SIRET (14 digits, returns single establishment), or search by company name with optional postal code,… |
| Regions | ||
| GET |
getDepartmentsByRegion /geographical_repository/v1/regions/{code}/departments |
Returns all departments for a specific region |
| GET |
getRegionByCode /geographical_repository/v1/regions/{code} |
Returns a specific region with all its departments |
| GET |
getAllRegions /geographical_repository/v1/regions |
Returns list of all 18 French regions (13 metropolitan + 5 DOM) with their department codes |
| Search | ||
| POST |
reindex /geographical_repository/v1/search/reindex |
Drops the existing index and reindexes all French cities from PostgreSQL. This operation may take several seconds depending on database size. |
| GET |
stats /geographical_repository/v1/search/stats |
Returns current index stats including document count, index name, and health status. |
| Countries | ||
| GET |
getCountry /geographical_repository/v1/countries |
Search for countries by name with optional exact matching. Returns ISO 3166-1 alpha-2/alpha-3 codes, country labels, and status. Available on all plans (FREE+). |
| Billing | ||
| GET |
getBillingStatus /geographical_repository/v1/billing/status |
Returns the billing status for the current API key: plan, subscription status, invoices. |
| POST |
createCheckout /geographical_repository/v1/billing/checkout |
Creates a Stripe Checkout session to upgrade to STARTER or PRO plan. Returns a checkout URL for redirection. |
| POST |
createPortal /geographical_repository/v1/billing/portal |
Creates a Stripe Customer Portal session. User can manage subscription and payment methods. |
| POST |
cancelSubscription /geographical_repository/v1/billing/cancel |
Cancels the subscription at end of billing period. Key keeps current plan until period ends. |
| Commune History | ||
| GET |
getHistory /geographical_repository/v1/cities/{insee_code}/history |
Returns all historical events for a commune with optional filtering |
| GET |
getSuccessor /geographical_repository/v1/cities/{insee_code}/successors |
Returns the current commune that absorbed/replaced this one, or null if still active |
| Developer Portal | ||
| POST |
register /geographical_repository/v1/api/register |
Create a new FREE plan API key. Requires name and email. One key per email address. The full API key is shown only once in the response — save it immediately. |
| POST |
recover /geographical_repository/v1/api/recover |
Returns a masked hint of your API key. The full key was shown only once at registration. |
| Departments | ||
| GET |
getCitiesByDepartment /geographical_repository/v1/departments/{code}/cities |
Returns all cities/towns in a specific department with pagination support |
| GET |
getAllDepartments /geographical_repository/v1/departments |
Returns list of all 101 French departments (96 metropolitan + 5 DOM) with their region information |
| GET |
getDepartmentByCode /geographical_repository/v1/departments/{code} |
Returns a specific department with region information |
| API Info | ||
| GET |
getApiInfo /geographical_repository/v1/api/info |
Returns your plan, quotas, current usage, and available features. |
| Usage | ||
| GET |
getUsage /geographical_repository/v1/api/usage |
Returns usage breakdown for your API key. Supports period: today, week, month, or custom with from/to dates. |
GEOREFER pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO Recommended | $55 / month | 30 / minute |
|
| ULTRA | $220 / month | 60 / minute |
|
