EcuaPass for developers and partners

Connect your service to EcuaPass.

Read public Ecuador visa planning information, connect an AI assistant, or refer a client for Chip's personal review. Scope and fees are agreed with the client before paid work begins.

OpenAPI specificationExplore the public catalogRequest partner access

REST API

The catalog is public and available in English. Source links and existing editorial dates travel with each route; API access does not recheck government requirements. Preparation topics are incomplete and do not establish eligibility or filing readiness.

EcuaPass API endpoints
MethodEndpointPurpose
GET/api/v1/visa-routesList public routes and their source links.
GET/api/v1/visa-routes/{slug}Read one route's planning summary and review metadata.
GET/api/v1/checklists/{slug}Read limited preparation topics for a route.
POST/api/v1/referralsSubmit a consented inquiry from an approved partner's server.
curl https://ecuapass.com/api/v1/visa-routes
curl https://ecuapass.com/api/v1/checklists/retirement-visa

Connect an AI assistant with MCP

In a compatible MCP client, add a remote HTTP server with the URL below and no authentication. It offers four read-only tools: list_visa_routes, get_visa_route, get_visa_checklist, and get_intake_link.

https://ecuapass.com/api/mcp

The tools return public information or an intake link. Submit personal details through the intake page or the authenticated partner API. A compatible client must connect to use these tools.

Partner referrals

Approved relocation businesses and other partners can submit a short inquiry from their server. Ask the client's explicit permission to share their details with EcuaPass for follow-up, then send consent: true. Leave out passport numbers, financial documents and other sensitive records.

const response = await fetch("https://ecuapass.com/api/v1/referrals", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer " + process.env.ECUAPASS_PARTNER_KEY,
    "Idempotency-Key": "YOUR_UNIQUE_REFERRAL_ID"
  },
  body: JSON.stringify({
    name: "Example Client",
    email: "client@example.com",
    visaRoute: "retirement-visa",
    message: "I would like help planning my move.",
    consent: true
  })
});
const result = await response.json();
if (!response.ok) throw new Error(result.error.message);
// Save result.data.reference with your referral record.
  • Keep the partner key on your server. Your credential determines the referring business; the request cannot override it.
  • Use one unique idempotency key per inquiry. Retry with the same key and unchanged body after a timeout or temporary failure. Completed retries return the same reference for seven days after completion.
  • Store the reference in your system. If an unresolved request is more than 23 hours old, contact EcuaPass with your partner ID and original idempotency key before resubmitting under a new key.
  • Requests accept up to 8 KiB. Partner limits allow up to 100 new inquiries per UTC day and 10 processing attempts per minute. Individual partners may have lower daily limits.
  • A received inquiry enters personal review. It does not submit a government application, subscribe the client to marketing, or establish commission eligibility.

Request partner access with your business name and intended integration.