Schengen 90/180 & Residence Day Calculator API

Give it travel dates and get the answer immigration and tax rules actually ask: how many days count, how many are left, the first day a limit was broken, and whether a planned trip fits. One engine, nine rules, each counting travel days the way its own official guidance says.

No scraping and no outside calls: the calculation runs on the dates you send, and results go only to your own run storage.

Rules

Rule	Question it answers	How a travel day counts
schengen-90-180	Short stays: at most 90 days in any 180-day period across the Schengen area	entry and exit days both count (European Commission method)
uk-settlement-180	UK settlement: absences of at most 180 days in any 12 months	whole days abroad only; travel days are not absence days
uk-naturalisation	UK citizenship by naturalisation: at most 450 days outside the UK in 5 years (270 in 3 years for a British citizen's spouse or civil partner), at most 90 in the last 12 months, and present on the first day	whole days abroad only; Jersey, Guernsey and the Isle of Man count as the UK
uk-srt-day-count	UK days per tax year (6 April to 5 April) and the 183-day automatic UK test	a day counts if you are in the UK at the end of it
us-substantial-presence	US substantial presence test for a calendar year	any part of a day counts; weighted over three years
us-330-day	US physical presence test for the foreign earned income exclusion	only full days outside the US; finds the best 12-month window
canada-citizenship-1095	Canadian citizenship: 1,095 days in the 5 years before applying, with half-day credit for time before permanent residence	departure and return days count as days in Canada
canada-pr-730	Canadian permanent residence: 730 days in the last 5 years	same as citizenship
rolling-183	Days in one country in any 12-month period and per calendar year	any part of a day counts

Each result names its official source and the date it was checked.

What you get

One row per traveller and rule: days counted, the limit, days remaining, status, the window used, the first breach date and every period over the limit, the earliest date you become eligible (citizenship), and for a planned trip: does it fit, how long you can stay, the latest exit and the earliest entry that works. Every row also lists what the rule does not model (for example visa-specific limits) and any warnings.

Use it for

• Travel and relocation apps: check a customer's itinerary before they book.
• HR and mobility teams: flag employees close to a Schengen, UK or US day limit.
• Immigration and tax advisers: a fast first count before the detailed review.
• AI agents: "can I spend 20 more days in France this summer?" answered exactly.

How to use it

Add travellers, each with an ref label of your choice (no names needed) and a list of trips { country, from, to } with ISO country codes and inclusive dates. Choose the rules, and optionally an asOf date and a planned trip. For the Canadian rules, list your trips abroad and add your permanent residence date.

Or paste trips as plain lines, one per trip: FR 2026-03-01 2026-03-30 (dashes, to and commas work too; # starts a comment).

Leave the input empty and it runs one example traveller.

Output example

Real output (shortened): 75 days in Spain and 31 in France, checked on 1 June 2026 with a planned 20-day trip to France from 1 July.

{
  "ref": "T1",
  "rule": "schengen-90-180",
  "daysCounted": 106,
  "limit": 90,
  "remaining": -16,
  "status": "over",
  "firstBreachDate": "2026-05-16",
  "plan": { "entry": "2026-07-01", "days": 20, "fits": false, "maxStay": 0, "earliestEntry": "2026-07-20" }
}

Pricing

What	Price
One rule checked for one traveller	$0.004
Planned-trip answer (fits, latest exit, earliest entry)	$0.008, on top
Run start	$0.00005 per run (5 cents per 1,000 runs)

Rows with invalid input are free. Free Apify plan: up to 20 results per run.

Important

Not legal or tax advice. Rules have exceptions this tool does not model (they are listed in each result). Check the official rules or a qualified adviser before you rely on a result.

Support

Questions or a rule you would like added: open an issue on this page.