Catalog
Complete route map for countries, cities, selections and export templates.
Data downloads
JSON and CSV exports for the public Migration Fit country and city catalog.
Last updated
Available downloads
| File | Format | Contents |
|---|---|---|
| catalog.json | JSON | Index of countries, cities and available export paths. |
| openapi.yaml | OpenAPI 3.1 | Machine-readable contract for the static JSON, CSV and bulk endpoints. |
| .well-known/ai-plugin.json | JSON | AI plugin discovery metadata pointing agents to OpenAPI, contact and license policy. |
| cities.csv | CSV | City list with country and update date. |
| bulk/manifest.json | JSON | Bulk dump manifest with per-country file size, SHA-256 and data version. |
| bulk/de.json.gz | JSON.GZ | One-country bundle with country, cities, regions, comparisons and selections available in the current build. |
| metrics/ | HTML | Metric dictionary with definitions, source grades and coverage. |
| metrics/{metric_id}.json | JSON | Machine-readable metric definition and coverage snapshot. |
| tax-rules/{cc}-{year}.json | JSON | Versioned net-salary rule set with thresholds, rates, sources, assumptions and a default modeled result. |
| move-cost-rules/{cc}.json | JSON | Country-level move-cost rules with deposit norm, first-month line items, route metadata and checklist templates. |
| countries/{cc}.json | JSON | Country profile export with visible indicators and links. |
| legal/catalog.json | JSON | Catalog of passport legal pages and per-passport JSON exports. |
| legal/passport/{cc}.json | JSON | Per-passport legal stay matrix with destination rules, official sources, dates and grades. |
| reports/catalog.json | JSON | Catalog of public question-driven reports with HTML, JSON and CSV routes. |
| reports/{slug}.json | JSON | Machine-readable export for a public question-driven report, including rows, formulas and source links. |
| profiles/{profile}/{cc}.json | JSON | Country-profile ranking export with weights, coverage gate, relevant routes and ranked rows. |
| routes/{from}-{to}.json | JSON | Origin-to-destination corridor export with entry access, official routes, timeline, best cities and source links. |
| cities/{cc}/{slug}.json | JSON | City profile export with visible indicators and links. |
| timeseries/{metric_id}/{entity_id}.json | JSON | Historical observations plus the current significant trend for one metric and one published entity. |
| compare/brno-vs-amsterdam.json | JSON | Side-by-side city comparison export. |
Catalog scope
| Data | Count | Browse |
|---|---|---|
| Countries | 20 | Open country directory |
| Cities | 5731 | Open city directory |
| Popular comparisons | 87 | Open comparison directory |
| Metrics | 86 | Open metric dictionary |
| Bulk dumps | 20 | Open bulk manifest |
| Question-driven reports | 9 | Open reports hub |
| Profile rankings | 6 | Open profile hub |
| Corridor pages | 53 | Open routes hub |
| Metric timeseries | 4672 | Open catalog |
API explorer
Move-cost sample
Reusable country-level setup-cost rules plus a browser-only estimator that combines them with city JSON.
Tax rule sample
Versioned salary-rule JSON plus a browser-only calculator page using the same published assumptions.
Country sample
Country-level metrics, legal routes, benefits and source-linked values.
Legal sample
Passport-by-destination rules with official sources, dates and grades.
Report sample
Question-driven rankings with formulas, row-level source links and CSV/JSON exports.
Profile sample
Published profile ranking with fixed scoring weights, gate status and route context.
Corridor sample
Passport-to-destination corridor with entry access, official routes, timeline and best cities.
City sample
City-level metrics, relocation signals, cost snapshot and citation atoms.
Bulk sample
Gzipped per-country bundles with checksums in the manifest.
Connect
MigrationFit publishes a read-only Model Context Protocol (MCP) server that gives AI assistants direct, structured access to migration data — rent, salaries, air quality, legal routes and more for thousands of cities across Europe and beyond. Every response carries its source, observation date and a CC BY 4.0 citation, so attributing the data is automatic.
FAQ
What can I download?
The public catalog, city CSV file, country JSON files, city JSON files and comparison JSON files.