API Documentation

Technical overview of Atlas Sovereign's AI-powered visa compliance platform

Platform Overview

Atlas Sovereign is built on a modern tech stack optimized for real-time AI processing, global data accuracy, and secure user privacy.

Core Technologies

  • • Next.js 15 (React Framework)
  • • Perplexity AI (Sonar models)
  • • Supabase (PostgreSQL + Storage)
  • • Clerk (Authentication)
  • • Stripe (Payments)

Data Sources

  • • 180+ government immigration portals
  • • International tax databases
  • • Real-time travel advisory feeds
  • • Weather & cost of living APIs
  • • User-submitted passport scans

Core API Endpoints

Visa Entries API

/api/visa-entries

GET / POST

Manage user visa entries (country stays) with automatic day counting and Schengen tracking.

// GET - Fetch all entries
GET /api/visa-entries?userId=user_123
// POST - Add new entry
POST /api/visa-entries
{ country, entryDate, exitDate, userId }

Passport Scanner API

/api/scan-passport

POST

AI-powered passport stamp recognition using Perplexity Vision API (Sonar-Pro model).

// Send base64 image
POST /api/scan-passport
{ image: "data:image/jpeg;base64,..." }
// Returns
{ country, entryDate, confidence }

Yearly Plan API

/api/yearly-plan

GET / POST / PUT / DELETE

Full CRUD operations for user travel plans with AI-powered city suggestions.

// Get user plan
GET /api/yearly-plan?userId=user_123&year=2025
// Update month
PUT /api/yearly-plan
{ month, city, country, userId }

Batch Plan API

/api/batch-plan

POST

AI-powered batch planning for multiple months with preferences (climate, budget).

// Plan 3+ months at once
POST /api/batch-plan
{ months: [1,2,3], preferences: { budget, climate } }

Flag Theory API

/api/flag-theory

POST

AI recommendations for optimizing residency, citizenship, business, banking, and assets.

// Get personalized recommendations
POST /api/flag-theory
{ citizenship, income, businessType }

Country Comparison API

/api/country-compare

GET

Real-time country comparison with visa policies, taxes, cost of living, and more.

// Compare 2+ countries
GET /api/country-compare?countries=Portugal,Thailand

AI Models Used

Perplexity Sonar

Real-time web search and policy analysis

  • • Travel planning recommendations
  • • Visa policy updates
  • • Tax regulation analysis
  • • Country comparisons

Perplexity Sonar-Pro

Vision model for passport scanning

  • • Passport stamp recognition
  • • Date extraction (entry/exit)
  • • Country identification
  • • Confidence scoring

Data Security & Privacy

Encryption

  • • All data encrypted in transit (TLS 1.3)
  • • Database encryption at rest
  • • Secure file storage (Supabase)
  • • No plaintext passwords

Compliance

  • • GDPR compliant data handling
  • • User data export available
  • • Right to deletion honored
  • • No data sold to third parties

Rate Limits & Performance

EndpointRate LimitAvg Response
/api/visa-entries100/min~50ms
/api/scan-passport10/min~3-5s
/api/batch-plan5/min~8-12s
/api/flag-theory10/min~4-6s

Want API Access?

We're building a public API for developers. Join the waitlist to be notified when it launches.

Request API Access