Enter Finland APIenterfinland.fi ↗
Access Finnish immigration permit categories, page content, and help topics from the Enter Finland portal via a structured API with 3 endpoints.
What is the Enter Finland API?
The Enter Finland API provides structured access to Finnish immigration information across 3 endpoints, covering residence permit categories, detailed page content, and help topics from the Finnish Immigration Service's official portal. The list_permit_categories endpoint returns all permit types with names, descriptions, slugs, and URLs, while get_page_content retrieves section-level content for any permit information page by slug.
curl -X GET 'https://api.parse.bot/scraper/83ede0d8-26e2-46ee-a63b-a576a5bc2b11/list_permit_categories?language=en' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace enterfinland-fi-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Enter Finland SDK — bounded, re-runnable; every call capped."""
from parse_apis.Enter_Finland_API import EnterFinland, Language, PageNotFound
client = EnterFinland()
# List all permit categories in English
for category in client.permit_categories.list(language=Language.EN, limit=5):
print(category.name, "-", category.description)
# Get details of a specific information page using its slug
page = client.pages.get(page_slug="residencepermit", language=Language.EN)
print(page.title, "|", page.url)
for section in page.sections[:3]:
print(f" Section: {section.heading}")
# Handle a page that doesn't exist
try:
client.pages.get(page_slug="nonexistent_page")
except PageNotFound as exc:
print(f"Page not found: {exc.page_slug}")
# Browse help topics
for topic in client.help_topics.list(language=Language.EN, limit=3):
print(topic.title, "-", topic.content[:80])
print("exercised: permit_categories.list / pages.get / help_topics.list / PageNotFound")
Lists all available permit application categories from the Enter Finland home page. Returns category names, descriptions, URLs, and slugs for each permit type (first permit, extended permit, permanent residence, seasonal work, EU registrations, Finnish citizenship, Brexit, renewing card, temporary protection). Results are returned in a single page.
| Param | Type | Description |
|---|---|---|
| language | string | Language for content. Determines the language of returned category names and descriptions. |
{
"type": "object",
"fields": {
"total": "integer",
"language": "string",
"categories": "array of permit category objects with name, description, url, slug"
},
"sample": {
"data": {
"total": 11,
"language": "en",
"categories": [
{
"url": "https://enterfinland.fi/eServices/info/residencepermit",
"name": "First permit",
"slug": "residencepermit",
"description": "When you do not have a residence permit and you plan to move to Finland."
},
{
"url": "https://enterfinland.fi/eServices/info/residenceextension",
"name": "Extended permit",
"slug": "residenceextension",
"description": "When your current residence permit is about to expire."
}
]
},
"status": "success"
}
}About the Enter Finland API
What This API Returns
The Enter Finland API surfaces publicly available immigration information from the Finnish Immigration Service's enterfinland.fi portal. list_permit_categories returns a list of all permit application types available on the home page, including the name, description, url, and slug for each category — covering types like first permits, extended permits, permanent residence, seasonal work, EU registrations, Finnish citizenship, and Brexit-related permits. The language parameter controls the language of all returned text across every endpoint.
Page Content and Sections
get_page_content accepts a required page_slug (e.g., residencepermit, workpermit, permanentresiden) and returns the page title, an array of sections each with a heading and content, outbound links with text and URL, a breadcrumb array, and a full_text field of up to 5,000 characters. Slugs can be sourced from list_permit_categories or passed directly using known values. This is useful for extracting structured guidance from any specific permit information page.
Help Topics
get_help_topics retrieves all help topics from the Enter Finland help page in a single call. Each topic in the returned array includes a title and content field with the full expanded text. Topics span subjects like using the Enter Finland service, payments, appointment booking, handling times, and applicant FAQs. The total field indicates how many topics were returned. Like all endpoints, it accepts an optional language parameter.
The Enter Finland API is a managed, monitored endpoint for enterfinland.fi — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when enterfinland.fi changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official enterfinland.fi API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a multilingual guide to Finnish visa types by pulling category names and descriptions from
list_permit_categories - Populate a relocation assistant with detailed permit requirements using
get_page_contentfor slugs likeworkpermitandresidencepermit - Index Finnish immigration help content into a searchable knowledge base using
get_help_topics - Surface relevant permit categories in a chatbot by matching user queries against category slugs and descriptions
- Compile a structured overview of permanent residence requirements by extracting sections and headings from
get_page_content - Track changes in official Finnish immigration guidance by periodically fetching and comparing
full_textfrom known page slugs - Provide HR teams with up-to-date Finnish work permit information pulled directly from the official government portal
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the Finnish Immigration Service provide an official developer API for enterfinland.fi?+
What does `get_page_content` return and how do I know which slugs are valid?+
get_page_content returns the page title, an array of sections (each with a heading and content), outbound links, a breadcrumb array, and full_text up to 5,000 characters. Known valid slugs include residencepermit, workpermit, residenceextension, and permanentresiden. You can also obtain slugs dynamically from the slug field in list_permit_categories responses.Does the API return information about individual application status or account data from Enter Finland?+
Is the content available in multiple languages?+
language parameter that controls the language of returned text, including category names, page content, and help topic text. The available languages correspond to those supported by the Enter Finland portal itself.