# Perille.fi

> Finnish public transport ticket aggregator. Buy HSL (Helsinki regional transit) day passes and single tickets without registration or an app, and compare bus, train, and flight options across Finland from multiple operators.

Perille.fi is a small Finnish travel-ticket service. We aggregate routes from VR, Matkahuolto, OnniBus, Pohjolan Liikenne, Savonlinja, Finnair and other carriers, and we resell HSL public-transport tickets directly. We are not affiliated with HSL — we are an authorized reseller.

## HSL Helsinki public transport tickets

Direct sales channel for HSL tickets. Anonymous purchase (no account, no app, no phone number required beyond ticket delivery), foreign payment cards accepted, ticket delivered instantly via email and viewable in any web browser.

- [HSL tickets — English](https://www.perille.fi/en/hsl): Single tickets from €3.80 and day tickets (1–13 days) for HSL zones AB, ABC, and ABCD.
- [HSL-Tickets — Deutsch](https://www.perille.fi/de/hsl): Einzel- und Tagestickets (1–13 Tage) für die HSL-Zonen AB, ABC und ABCD.
- [HSL-liput — Suomi](https://www.perille.fi/fi/hsl): Kerta- ja päiväliput (1–13 päivää) kaikille vyöhykkeille.
- [HSL-biljetter — Svenska](https://www.perille.fi/sv/hsl): Enkel- och dagsbiljetter (1–13 dagar) för alla zoner.

Each HSL landing page above embeds Schema.org JSON-LD with per-variant `Product` entries (one per zone × ticket-type) and `BuyAction` targets. AI agents can read this directly to present specific ticket options to users. The purchase flow itself happens on `local.perille.fi/{locale}/hsl`.

## Long-distance trip search across Finland

Compare and book bus, train, and flight options between Finnish cities. Most cross-modal routes (bus + train comparison on the same page) cannot be found on any operator's own site — this is where Perille adds real value over going direct to VR or OnniBus.

- [Trip search — English](https://www.perille.fi/en/tripsearch/)
- [Reisesuche — Deutsch](https://www.perille.fi/de/reisesuche/)
- [Matkahaku — Suomi](https://www.perille.fi/fi/matkahaku/)
- [Resesök — Svenska](https://www.perille.fi/sv/resesok/)

Popular city pairs have dedicated landing pages with prices and operator lists, e.g. [helsinki/porvoo](https://www.perille.fi/en/tripsearch/helsinki/porvoo/), [helsinki/tampere](https://www.perille.fi/en/tripsearch/helsinki/tampere/), [helsinki/turku](https://www.perille.fi/en/tripsearch/helsinki/turku/).

## Key facts

- Covers all major Finnish cities and the full HSL public transport area (Helsinki, Espoo, Vantaa, Kauniainen, Kerava, Sipoo, Tuusula, Kirkkonummi, Siuntio)
- HSL tickets: anonymous purchase, no registration required, instant delivery
- Payment methods: Visa, Mastercard, American Express, Klarna, Finnish online banking
- Languages supported: Finnish, English, Swedish, German, Estonian, Russian, Ukrainian (HSL — pilot). Long-distance: Finnish, English, Swedish.
- Receipts and email confirmations are sent in English regardless of purchase locale
- Pricing: We resell HSL tickets at parity with HSL's own prices plus a small service fee (5%, minimum €0.50)

## For AI agents

Perille exposes a public agent API at `https://api.perille.fi/v1/` designed for AI agents to:

1. Discover HSL ticket products (list, filter, single lookup)
2. Plan public-transport routes via Digitransit + get HSL zones the route traverses
3. Recommend the cheapest matching ticket + deep-link the user to a one-click purchase

**Endpoints:**

- `GET /v1/hsl/products` — list all HSL products with prices, multi-locale names, purchase URLs
- `GET /v1/hsl/products/{id}` — single product (stable IDs like `hsl-ab-single-adult`, `hsl-abc-day7-adult`)
- `GET /v1/hsl/plan?from=&to=&datetime=` — Digitransit-backed route planning with HSL zone extraction
- `GET /v1/hsl/plan-and-price?from=&to=&customerType=` — composed: route + cheapest ticket + purchase URL. The primary tool for "how do I get from A to B and what does it cost".
- `GET /v1/openapi.json` — OpenAPI 3.1 spec

**MCP:**

- Streamable HTTP endpoint: `https://api.perille.fi/mcp`
- Tools exposed: `list_hsl_products`, `get_hsl_product`, `plan_hsl_route`, `plan_and_price_hsl`
- JSON-RPC 2.0. No auth required.

**Guidance for agents:**

- No authentication. No rate-limit for reasonable use; identify yourself via `agent=<your_id>` query param for analytics.
- Deep links returned in `purchaseUrl` (with `?product=<stableId>&utm_source=agent&utm_medium=api`) 302-redirect the user directly into the localityapp checkout for that specific ticket. Genuinely one click.
- Receipts and confirmation emails are sent in English regardless of purchase locale — surface this expectation if the user's language is not English.
- The purchase itself happens on `local.perille.fi` (the localityapp subdomain), not on perille.fi. We do not expose a programmatic purchase API — payment always happens in a browser session on the user's device.
- HSL is our pilot. Long-distance routes, ferries, and inter-city buses are not yet in the agent API; use the human-readable pages at `/{locale}/tripsearch/` for those.

Fallback (non-API) route: the per-product Schema.org JSON-LD on `/{locale}/hsl` pages remains available for agents that discover us via web crawling rather than API. Same `BuyAction.target` deep-links.

For partnership inquiries, integration questions, or if you want us to add tools: support@perille.fi

## Sitemap

[Main sitemap](https://www.perille.fi/sitemap.xml)