Skip to content

About

The world's first open-source, community-maintained visa requirements database for diaspora travelers.

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

334 Commits

Folders and files

Repository files navigation

πŸ›‚ Diaspora Visa Data

The world's first open-source, community-maintained visa requirements database for diaspora travelers.

Data Freshness Contributors License


🌍 What Makes This Different

Every visa API answers the same question: "Can passport X enter country Y?"

We answer a different question:

"I'm Ghanaian with a UK dependent visa β€” how many countries can I enter without another visa?"

This is the only visa database that understands document combinations, not just passports.


πŸ“Š Current Coverage

126 Origin Countries | 24,948 Visa Routes | 198 Destinations Per Country

Region Countries Example Origins
🌍 Africa 54 Ghana, Nigeria, Kenya, South Africa, Egypt, Morocco
🌏 Asia 35 India, Pakistan, Bangladesh, Philippines, Vietnam
🌎 Americas 20 Brazil, Mexico, Colombia, Jamaica, Trinidad
🌍 Europe 10 Turkey, Albania, Ukraine, Serbia
🌏 Oceania 7 Fiji, Papua New Guinea, Vanuatu

Summary

Visa Policy Routes
🟒 Visa Free 9,368
🟑 eVisa 4,454
🟠 Visa on Arrival 3,970
πŸ”΄ Visa Required 7,116
πŸ”΅ ETA / No admission 40

Counts as of 16 October 2026. Of the 24,948 routes, 981 are marked verified; the rest are still unverified. Verifying them against official government sources is what the bounties are for.


πŸ—‚οΈ Repository Structure

diaspora-visa-data/
β”œβ”€β”€ data/
β”‚   β”œβ”€β”€ passport-requirements/     # Base passport β†’ country rules
β”‚   β”‚   β”œβ”€β”€ GH.json               # Ghana passport
β”‚   β”‚   β”œβ”€β”€ NG.json               # Nigeria passport
β”‚   β”‚   └── ...
β”‚   β”‚
β”‚   β”œβ”€β”€ document-privileges/       # Document β†’ unlocked countries
β”‚   β”‚   β”œβ”€β”€ UK-visa.json          # UK visa privileges
β”‚   β”‚   β”œβ”€β”€ US-visa.json          # US visa privileges
β”‚   β”‚   β”œβ”€β”€ CANADA-pr.json        # Canadian permanent resident privileges
β”‚   β”‚   └── ...
β”‚   β”‚
β”‚   └── countries/                 # Country reference data
β”‚       └── index.json            # All countries
β”‚
β”œβ”€β”€ sources/
β”‚   └── verified-domains.json      # Trusted government domains
β”‚
β”œβ”€β”€ bounties/
β”‚   └── open.json                  # Available bounties
β”‚
└── .github/
    └── workflows/                 # Source checks, labels, database sync

🀝 Contributing

We welcome contributions! Every visa rule change, every new route, every correction helps thousands of diaspora travelers.

Quick Start

  1. Fork this repository
  2. Find data to update β€” Check bounties/open.json for needed updates
  3. Make your changes β€” Edit the relevant JSON file
  4. ⚠️ REQUIRED: Include official government source URL β€” Every change MUST link to the official government immigration/visa website
  5. Submit PR β€” Our automation verifies your sources automatically
  6. Wait for verification β€” Bot will comment βœ… or ❌ on your PR
  7. Email for payment β€” Once verified, email contributors@diasporaai.dev with your payment details (bounties are paid monthly, on the 11th)

How Bounty Payments Work

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  Submit PR      │───►│  Auto-Verify    │───►│  βœ… Verified    β”‚
β”‚  with sources   β”‚    β”‚  Government     β”‚    β”‚  Comment on PR  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β”‚  URLs           β”‚    β””β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                       β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜             β”‚
                                                       β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  Manual Payment │◄───│  Cross-check    │◄───│  Email          β”‚
β”‚  via PayPal/    β”‚    β”‚  PR details     β”‚    β”‚  contributors@  β”‚
β”‚  Wise/Bank      β”‚    β”‚                 β”‚    β”‚  diasporaai.dev β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Source URL Requirements

Every contribution MUST include:

  • Direct URL to the official government visa/immigration page
  • The exact page where the information can be verified
  • Date you accessed the source

Example acceptable sources:

  • https://www.gov.uk/check-uk-visa/y/ghana/tourism
  • https://travel.state.gov/content/travel/en/us-visas.html
  • https://www.migration.gv.at/en/types-of-immigration/

See CONTRIBUTING.md for detailed guidelines.

Bounty Rewards

Contribution Type Reward
Verified update to one route Β£2
New origin country (50+ routes) Β£10
Critical policy change Β£5
Document privilege rules Β£3
Bug fix / correction Β£2
Verify existing data Β£1

See CONTRIBUTING.md for payment details.


πŸ“‹ Data Schema

All data follows a strict schema. See SCHEMA.md for full documentation.

Example: Passport Requirement

{
  "route": "GH β†’ GB",
  "from": "GH",
  "to": "GB",
  "visa": {
    "required": true,
    "policy": "visa_required",
    "type": "Standard Visitor Visa",
    "maxStayDays": 180,
    "evisaAvailable": false,
    "visaOnArrival": false
  },
  "documents": {
    "passportValidityMonths": 6,
    "blankPages": 2,
    "proofOfFunds": true,
    "returnTicket": true
  },
  "source": {
    "url": "https://www.gov.uk/check-uk-visa",
    "verified": "2026-03-01",
    "confidence": "verified"
  }
}

Example: Document Privilege

{
  "document": {
    "type": "visa",
    "country": "GB",
    "categories": ["visitor", "work", "student", "dependent"]
  },
  "unlocks": [
    {
      "country": "AL",
      "name": "Albania",
      "conditions": "Valid UK visa",
      "maxStayDays": 90,
      "source": "https://punetejashtme.gov.al/"
    }
  ]
}

βœ… Verification Process

  1. Source Required β€” Every contribution must include an official source URL
  2. Automated Check β€” GitHub Actions verify the source domain is legitimate
  3. Human Review β€” Maintainers review edge cases
  4. Auto-Deploy β€” Verified data deploys to production API

πŸ† Top Contributors

Rank Contributor Contributions Countries
πŸ₯‡ samproductnotes-crypto 12 4
πŸ₯ˆ Mhamed Askoure 10 7
πŸ₯‰ BeakDo 10 0
4 void389 7 7
5 gonzalogamiz 7 5
6 angeloasante 6 128
7 soundcake 5 1
8 chen418318-cloud 4 1
9 Xiaolong Pan 4 1
10 zongsm-cmyk 3 20

πŸ”’ License & Attribution

This dataset is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).

You are free to:

  • Share β€” copy and redistribute the material in any medium or format
  • Adapt β€” remix, transform, and build upon the material for any purpose, even commercially

Under these terms:

  • Attribution β€” You must give appropriate credit and link to diasporaai.dev

Example Attribution

<p>Visa data powered by <a href="https://diasporaai.dev">Diaspora AI</a></p>
Visa data provided by [Diaspora AI](https://diasporaai.dev)

Logo Assets

For attribution, logos are available in this repo:

  • logo.png (favicon size)
  • logo-512.png (high resolution)

οΏ½ API Endpoints

The data in this repository powers a live API. Here are the key endpoints:

Document Privileges

Get countries unlocked by a visa:

GET /api/visa/document-privileges?documentType=UK

Response:

{
  "documentType": "UK",
  "privileges": [
    {
      "destination_country": "Albania",
      "destination_code": "AL",
      "max_stay_days": 90,
      "conditions": "Valid UK visa (any type)"
    }
  ],
  "totalDestinations": 31
}

Combined Access (Passport + Visa)

Calculate total countries accessible with a passport AND visa:

GET /api/visa/combined-access?passportCountry=GH&documentType=UK

Response:

{
  "passport": "GH",
  "document": "UK visa",
  "totalEasyAccess": 118,
  "newlyUnlocked": 16,
  "breakdown": {
    "visaFree": 65,
    "eVisa": 35,
    "visaOnArrival": 18,
    "documentPrivileges": 16
  }
}

Example Real Results:

Passport + UK Visa Easy Access Newly Unlocked
πŸ‡¬πŸ‡­ Ghana βœ… 118 +16
πŸ‡³πŸ‡¬ Nigeria βœ… 103 +19
πŸ‡ΏπŸ‡¦ South Africa βœ… 135 +13
πŸ‡°πŸ‡ͺ Kenya βœ… 108 +15

API Base URL: https://diasporaaibackend-production.up.railway.app

See full API documentation at flight-api/docs/VISA_API_DOCUMENTATION.md


οΏ½πŸ“ž Contact


πŸš€ Powered By

This data powers the Diaspora AI Visa API β€” the only API that understands multi-document travel privileges for African diaspora travelers.


Last updated: October 2026

About

The world's first open-source, community-maintained visa requirements database for diaspora travelers.

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages