EMSWe / NEMO developer resources · preview
Looking for the public site? emsw.fi
API-First · Stable formats · EMSA MIG aligned

Integrate with Finland's Maritime Single Window (NEMO)

Everything developers need: OpenAPI specs, message profiles, environments, and integration guides for EMSWe-compliant formalities and supporting services.

Browse APIs Read a quickstart Request credentials

APIs & Schemas

OpenAPI 3.0/3.1 · HTML · JSON schemas
Formalities
Nemo formalities

Nemo formalities

List of Data elements suggested by Finnish authorities to use, when submitting formalities.

HTML
National API
National API - Declarant

National Declarant API

National REST API for Declarants to see, insert, update and withdraw formalities from portcall. Create new portcall and see list of portcalls.

HTML
National API
National API - Port

National Port API

National REST API for Finnish Ports to see portcalls and formalities, vessel data and post port statistics.

HTML
Location
Location

Location Service API

EMSA Location data including national datasets.

HTML
Location
Hazmat

Hazmat Service API

EMSA hazmat data.

HTML
NSD
Nemo ship database

Nemo Ship Database

Nemo Ship database external APIs

HTML
Util
Nemo codelists

Nemo codelists

Codelists used by Nemo.

HTML
Rules, Conditions, guidance
RCG

Nemo / EMSA Rules, Conditions, Guidance

List of National and EMSA Rules, conditions and guidances.

HTML
EMSA MIG
MIG

EMSA Message implementation guide

The European Maritime Single Window environment (EMSWe) Regulation (EU) 2019/1239 (ref. R01), building on the existing Maritime National Single Windows (MNSWs), establishes a common, interoperable environment for the reporting of information from ships to shore during a port call. In particular, it empowers the European Commission to define a harmonised data set covering all reporting obligations and to develop and maintain common interfaces and services for the MNSWs.

HTML

Environments

Base URLs and current status (examples — replace with your hosts)
Environment Base URL Auth Status Notes
STG https://mnsw-stg.mnsw.fi/ OAuth2 (client credentials) Limited access Infra refresh at Fridays, Service refresh at Mondays
PRD https://mnsw.mnsw.fi/ OAuth2 (client credentials) Limited access Contact us for onboarding

Guides

Step-by-step instructions to get you productive
Onboarding

Request API Access

How to apply for credentials, required roles, and SLAs.

Contact form
Webinars

Webinar materials

Here is downloadable/viewable materials from our Nemo Webinars

Nemo Webinars
Quickstart

Call the API in 5 minutes

Get a token and perform your first PUT formalities submission.

Read guide

Changelog

Latest changes across APIs and docs
2025‑10‑02 - Formalities supported by Finland, Codelists updated.
2025-10-06 - Nemo Webinars page added.
2025-10-08 - Updated Formalities supported by Finland.
2025-10-09 - Updated Declarant API documentation. Formality withdrawal is now performed using the PUT method.
2025-10-17 - Updated Formalities to match "kansallinen sanomaopas" look and feel.
2025-11-04 - Updated Port API documentation. The NSD V2 Ship API has been introduced in the Port API.
2025-11-27
  • Updated Port API documentation
  • Updated Declarant API documentation
  • Code list harmonized with EMSA and standardized (column headers, translations, ordering)
  • Added "Datamallit, ilmoittaminen ja rajapinnat" and "Väylämaksut" webinars materials

Contact & Access

Onboarding and support