General business rules

This page is preliminary and will be supplemented during autumn 2026 as the development work on API version 12 progresses.

Rules for publishing content

Publishing content

Only content with Published status can be imported and updated through API version 12.
The language version of the service or service channel can only be published if the main responsible organisation of the service or the service channel organisation has been published in that language version.

Retrieving content

Only published content can be retrieved through the API.
Exception: Archived content (e.g. services and service channels) can be retrieved so that the integrator can delete the archived content from its own system.

Visibility of content in the Suomi.fi web service

The organisations, services and service channels that have been published are visible in Suomi.fi. If the organisation has no published services or service channels, its data will not be displayed.

General data rules

Rules for Content status

• Allowed status transitions are (will be supplemented later)

Language versions

• The possible language versions for content are Finnish, Swedish, English, Northern Sámi, Inari Sámi and Skolt Sámi.

Formatted text field

• Text that uses formatting (such as headings, lists, highlighting) can be entered into a field (e.g. Service description). Restrictions: images and hyperlinks cannot be added. The API receives and restores formatting according to the Markdown syntax.

Regional information

• Select one of the following: All of Finland, All of Finland except Åland, Limited area.
• If Limited area is selected as the regional information, see section Regional information - limited area.

Regional information - limited area

• Select at least one option (municipality, county or wellbeing services county).
• Municipality: one or more municipalities can be selected.
• County: one or more counties can be selected.
• Wellbeing services county: one or more wellbeing services counties can be selected.
• You can select several options for all of the following: Municipality, County, Wellbeing services county. In other words, it is possible to select, for example, three municipalities, one county and one wellbeing services county.

Service time

• See Business rules for service times

Phone number for a telephone service channel

• The area code is mandatory.
• The phone number is mandatory. Maximum length is 20 characters.
• Additional information is optional. Maximum length is 300 characters.
• Information on call prices is mandatory. Select one of the following: Payable, Free, Supplementary charge.
• A description of the price information is mandatory if the price information is set to Supplementary charge. Maximum length is 300 characters.

Web site

• The name is mandatory.
• The maximum length of the name is 100 characters.
• The web address is mandatory.
• The maximum length of the web address is 500 characters.
• The address must start with the following string: http:// or https://.
• A description is optional.
• The maximum length of the description is 500 characters.

Location information

Can be a street address, other location information or a foreign address

Contact information

This can be an email address, fax number, telephone number, web site, or postal address.

The postal address can be a street address, post office box address or a foreign address.

Email address

• The email address is mandatory.
• Maximum length is 100 characters.
• Additional information is optional. Maximum length is 150 characters.

User support - email address

• The email address is mandatory.
• Maximum length is 100 characters.

Fax number

• The country-specific area code is mandatory.
• The phone number is mandatory.
• The maximum length of the phone number is 20 characters.

Telephone number

• Is this a Finnish (nationwide) helpline that cannot be called from abroad, Yes/No.
• The area code is mandatory if the answer to "Is this a Finnish (nationwide) helpline" is No.
• The phone number is mandatory.
• Additional information is optional.
• Information on call prices is mandatory. Select one of the following: Payable, Free, Other.
• A description of price information is mandatory if the price information is set as Other.

Street address

• The street name is mandatory.
• The maximum length of the street name is 100 characters.
• A street number is optional.
• The maximum length of the street number is 30 characters.
• The postal code and city are mandatory.
• The maximum length of the postal code is 5 characters.
• Additional address information is optional. Maximum length is 300 characters.

Post office box address

• The post office box address is mandatory. Maximum length is 30 characters.
• The postal code and city are mandatory.
• The maximum length of the postal code is 5 characters.
• Additional address information is optional. Maximum length is 300 characters.

Other location information

• The postal code and city are optional.
• The maximum length of the postal code is 5 characters.
• Latitude is mandatory.
• Longitude is mandatory.
• Additional address information is optional. Maximum length is 300 characters.

Foreign address

• A foreign address as free text is optional. Maximum length is 500 characters.
• The country (country code) where the address is located is mandatory.

FSC data content identifiers (ids)

Content id - FSC internal id

A unique identifier generated for the content by the FSC. This always remains the same even if new versions of the content are published.

• The Content id is unique within the same FSC content type.

Content id - use in updates

• The content id is used to update content with API PUT methods

Version id - version identifier

A unique identifier generated for the content version by the FSC. All versions of the same content have the same content id and a different version id.

External identifier for FSC data content

External id - external identifier

A unique identifier for the content that comes from an external source system.

• The External id is unique within the same FSC organisation (API ID) and content type
• If the External id is not provided when the content is created, it cannot be added later.
• Please note that the External id cannot be used as an identifier for updating the content with API PUT or DELETE methods.

Examples by content type:

• Organisation: each organisation must have its own unique external id. This can be the same as the External id of a service or channel.
• Service: each service must have its own unique External id. This can be the same as the External id of an organisation or channel.
• Service channel: each service channel must have its own unique External id. This can be the same as the External id of an organisation or service.
• Exception: different service channel types (e.g. telephone service channel and service location) may not use the same External id.