Schengen 90/180 & Residence Day Calculator API
Pricing
from $2.80 / 1,000 rule checks
Count days for the Schengen 90/180 rule, UK settlement and Statutory Residence Test, US substantial presence and 330-day tests, and Canadian citizenship and PR. Get days used, days left, the first breach date and whether a planned trip fits. Every rule cites its official source.
One entry per traveller: { "ref": "t1", "trips": [{ "country": "FR", "from": "2026-05-01", "to": "2026-05-20" }] }. ref is your own opaque label (letters, digits, dots, dashes, underscores or colons): never a name, email, phone or document number. Each trip is a stay in one country, both dates inclusive (YYYY-MM-DD): from is the day you arrived, to the day you left. country is an ISO 3166-1 code (FR, GB, US, CA) or a subdivision where it matters (ES-CN Canary Islands, PT-20 Azores, FR-GF French Guiana). Optional per trip: status (confirmed, planned or estimated). Instead of (or as well as) trips, a traveller can have tripsText: plain text with one trip per line, such as "FR 2026-03-01 2026-03-30", "ES-CN 2026-01-05 to 2026-01-20" or "US 2026-02-10..2026-02-20" (# starts a comment; blank lines are ignored; a tripsText that is blank or only comments adds no trips and leaves the traveller's trips as they are). Optional per traveller, for the Canada rules: prDate (the day you became a permanent resident) and temporaryResidencePeriods ([{ from, to }] when you were in Canada as a temporary resident or protected person before that). For rules that count absences (UK settlement, Canada), days not inside any listed trip are treated as days at home, so list every trip abroad. Leave empty to run one built-in example traveller.
The quickest way to check one traveller: one trip per line, written COUNTRY ARRIVAL DEPARTURE with dates as YYYY-MM-DD, both days included. Examples: FR 2026-03-01 2026-03-30, ES-CN 2026-01-05 to 2026-01-20, US 2026-02-10..2026-02-20. Fields may also be separated by commas or tabs, and a status (planned or estimated) may follow the dates. Lines starting with # and blank lines are ignored; anything after # is a comment. Empty text is ignored; text with comments only and no trip lines gives an error row for this traveller (uncharged). A line that cannot be read gives an error row for this traveller, naming the line, and nothing is charged. If Travellers is also filled in, this text is one more traveller.
Rules to check for every traveller. Each traveller and rule gives one result row.
[ "schengen-90-180"]The date to report on (YYYY-MM-DD). Trips after it are included as planned travel. Defaults to today (UTC).
Optional question about a planned trip: { "entry": "2026-11-01", "days": 30, "country": "FR" }. For each rule it applies to, the result says whether it fits, the longest stay from that entry (maxStay, latestExit) and the earliest entry for a stay of that length. For UK settlement and Canada PR the planned trip is an absence abroad.
For canada-citizenship-1095 and uk-naturalisation: the date you will sign the application, or for the UK the date the Home Office receives it (YYYY-MM-DD). Defaults to the As of date.
For rolling-183: the ISO 3166-1 alpha-2 country to count (for example ES). If empty, the planned country is used, or else the country with the most days.
For uk-naturalisation. standard: section 6(1), 5-year qualifying period, at most 450 days outside the UK. spouse: section 6(2), for the husband, wife or civil partner of a British citizen, 3-year period, at most 270 days. Both: at most 90 days outside the UK in the final 12 months.