---

name: irma description: "Query the Finnish Orienteering Federation's IRMA system at irma.suunnistusliitto.fi. Look up orienteering competition results, search athlete/person results, get ranking statistics, and browse the competition calendar. Supports all orienteering disciplines: foot orienteering (suunnistus), ski orienteering (hiihtosuunnistus), and mountain bike orienteering (MTB). Triggers: irma, orienteering results, suunnistus tulokset, ski orienteering results, MTB orienteering results, Finnish orienteering, person results orienteering, orienteering rankings, athlete results Finland, competition calendar Finland, suunnistusliitto, Orienteering Finland results" allowed-tools: Bash(python3 *), Bash(curl *)

IRMA — Finnish Orienteering Results & Rankings

Query competition results, athlete statistics, and rankings from the Finnish Orienteering Federation's IRMA system at irma.suunnistusliitto.fi.

Overview

IRMA (Information and Result Management for Athletics) is the official system used by Orienteering Finland (Suomen Suunnistusliitto). It covers:

| Discipline | Finnish name | Code | |---|---|---| | Foot orienteering | Suunnistus | SUUNNISTUS | | Ski orienteering | Hiihtosuunnistus | HIIHTOSUUNNISTUS | | Mountain bike orienteering | Pyöräsuunnistus | MTB |

Quick Start

The IRMA web application is Vaadin-based and requires a browser session with CSRF token for its JSON endpoints. The helper script at scripts/irma_query.py handles this automatically.

Installation

pip install requests

Usage

1. List upcoming competitions (all disciplines)

python3 scripts/irma_query.py calendar

2. List competitions by discipline

# Foot orienteering
python3 scripts/irma_query.py calendar --discipline SUUNNISTUS

# Ski orienteering
python3 scripts/irma_query.py calendar --discipline HIIHTOSUUNNISTUS

# Mountain bike orienteering
python3 scripts/irma_query.py calendar --discipline MTB

3. Filter by time range

# Upcoming (next 7 days)
python3 scripts/irma_query.py calendar --upcoming ONE_WEEK

# Next month
python3 scripts/irma_query.py calendar --upcoming ONE_MONTH

# Specific year and month (e.g. June 2026)
python3 scripts/irma_query.py calendar --year 2026 --month 6

4. Search person / athlete results

# Search by athlete name (partial match supported)
python3 scripts/irma_query.py person "Firstname Lastname"

# Search by athlete name within a specific discipline
python3 scripts/irma_query.py person "Firstname Lastname" --discipline SUUNNISTUS

5. Get results for a specific competition

# First find the competition day ID from the calendar, then:
python3 scripts/irma_query.py results --day-id 1234567

# Download results as CSV
python3 scripts/irma_query.py results --competition-id 1208011 --format csv

6. Get rankings

# General rankings (current year)
python3 scripts/irma_query.py rankings

# Rankings by discipline
python3 scripts/irma_query.py rankings --discipline SUUNNISTUS

# Rankings filtered by class/series (sarja)
python3 scripts/irma_query.py rankings --discipline SUUNNISTUS --class H21

# Ski orienteering rankings
python3 scripts/irma_query.py rankings --discipline HIIHTOSUUNNISTUS

7. Browse competition calendar via public URL

Open the calendar directly:

# All competitions
curl -s "https://irma.suunnistusliitto.fi/public/competitioncalendar/list?year=upcoming&tab=competition&area=all&competition=ALL"

API Endpoints Reference

See references/api-endpoints.md for full API documentation.

Core endpoints

| Endpoint | Method | Purpose | |---|---|---| | /connect/CompetitionCalendarEndpoint/view | POST JSON | Competition calendar (requires session) | | /connect/CompetitionEndpoint/viewCompetitionDay | POST JSON | Single competition day details | | /irma/haku/ilmoittautumiset | GET CSV | Entries/registrations for a competition | | /irma/haku/tulokset | GET CSV | Results for a competition | | /public/competitioncalendar/list | GET HTML | Calendar browser UI | | /public/competition/view/{id} | GET HTML | Single competition page | | /public/club/list | GET HTML | Club directory |

Session setup (for JSON endpoints)

The JSON endpoints require a browser-like session with a CSRF token:

# Step 1: Fetch the main page and capture CSRF token + cookies
curl -s -c /tmp/irma_cookies.txt \
  "https://irma.suunnistusliitto.fi/public/competitioncalendar/list?year=upcoming&tab=competition&area=all&competition=ALL" \
  | grep -oP 'name="_csrf" content="\K[^"]+'

See references/session-setup.md for full session management details.

Calendar API payload

# POST to competition calendar endpoint
curl -s -X POST \
  "https://irma.suunnistusliitto.fi/connect/CompetitionCalendarEndpoint/view" \
  -H "Content-Type: application/json" \
  -H "X-CSRF-TOKEN: $CSRF_TOKEN" \
  -H "Origin: https://irma.suunnistusliitto.fi" \
  -b /tmp/irma_cookies.txt \
  -d '{
    "year": null,
    "month": "1",
    "upcoming": "ONE_WEEK",
    "disciplines": ["SUUNNISTUS"],
    "areaId": null,
    "calendarType": "all",
    "competitionOpen": "ALL"
  }' | python3 -m json.tool

Output Interpretation

Competition calendar fields

| Field | Description | |---|---| | competitionDayName | Name of the competition day | | competitionDate | Date (ISO format) | | dayId | ID used for detail queries | | organisingClubs | List of organising clubs | | disciplines | Orienteering discipline(s) | | registrationAllowed | Whether entries are still open |

Results CSV columns

The CSV from /irma/haku/tulokset contains:

• Competitor number, name, club, series/class, result time, position, points

Rankings fields

| Field | Description | |---|---| | rank | Overall ranking position | | name | Athlete full name | | club | Club name | | points | Ranking points (pisteet) | | series | Age/gender class (sarja) |

Examples

Find all ski orienteering competitions in 2026

python3 scripts/irma_query.py calendar --discipline HIIHTOSUUNNISTUS --year 2026

Find results for a specific athlete across all competitions

python3 scripts/irma_query.py person "Matti Meikäläinen"

Get top 10 rankings for men's elite (H21) foot orienteering

python3 scripts/irma_query.py rankings --discipline SUUNNISTUS --class H21 --top 10

Notes

• IRMA uses Vaadin Flow, so JSON endpoints require a valid session with CSRF token; the helper script manages this automatically.
• Results CSVs are available without authentication.
• The disciplines filter accepts a list; pass [] for all disciplines.
• Area IDs correspond to Finnish orienteering districts (piirit); see references/api-endpoints.md for the list.
• Competition day IDs (dayId) are used in detail queries; competition IDs (kilpailu) are used in CSV result downloads.

Related Links

• IRMA competition calendar
• Orienteering Finland (Suomen Suunnistusliitto)
• API endpoints reference
• Session setup guide