Regional Support

Five countries support regional holidays at launch. Regional queries require a Starter plan or above.

Supported Regions

Parameter Format

Use the ISO 3166-2 subdivision suffix only:

?country=US&region=NY     ✅ correct
?country=US&region=US-NY  ❌ rejected

Examples:

• US-NY becomes NY
• GB-ENG becomes ENG
• DE-BY becomes BY

The API accepts case-insensitive input and normalizes to uppercase. Leading and trailing whitespace is ignored.

Validation Order

Region validation follows a fixed order:

1. Is country a supported country code? → 400 invalid_country if not
2. Does this country support regions? → 400 invalid_region if not
3. Is the supplied region code valid for this country? → 400 invalid_region if not
4. Does the caller's plan allow regional queries? → 403 plan_upgrade_required if not

This means:

• An unknown country is always rejected before any region logic runs
• A valid region on a Free plan returns 403 plan_upgrade_required, not 400
• Sending a region for a country without region support (e.g., ?country=JP&region=TK) returns 400 invalid_region