enterfinland.fi APIenterfinland.fi ↗
Access official Finnish immigration information directly, including residence permit categories, detailed page content, and help topics from the Finnish Immigration Service's Enter Finland portal. Simplify your research on Finnish residence permits and citizenship applications by retrieving accurate, up-to-date information from the authoritative government source.
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 enterfinland.fi API
The enterfinland.fi API on Parse exposes 3 endpoints for the publicly available data on enterfinland.fi. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.