# Enterfinland — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> 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.

**Category:** Government & Public Data | **Website:** [enterfinland.fi/](https://enterfinland.fi/) | **Docs:** [parse.bot/marketplace/b5f9799c-497e-4c43-858e-4bf7e0a05846/enterfinland-fi-api](https://parse.bot/marketplace/b5f9799c-497e-4c43-858e-4bf7e0a05846/enterfinland-fi-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-enterfinland-fi-api-b5f9799c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_help_topics

Retrieves all help topics and their content from the Enter Finland help page. Each topic includes its title and the full expanded content text. Topics cover subjects like using Enter Finland, payments, user support, booking appointments, handling times, and FAQs for applicants, employers, and legal advisors.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `language` | string | No | Language for content. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-enterfinland-fi-api-b5f9799c/get_help_topics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language":"<string>"}'
```

### get_page_content

Retrieves the full content of an information page from Enter Finland by its page slug. Returns the page title, sections with headings and content, outbound links, and full text content. Use slugs from list_permit_categories or known values like 'residencepermit', 'workpermit', 'help', 'citizenships', 'seasonalwork'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `language` | string | No | Language for content. |
| `page_slug` | string | Yes | The page slug identifier. Known valid slugs: residencepermit, workpermit, residenceextension, permanentresidencepermits, seasonalwork, seasonalworkpermittypeselection, seasonalworkcertificate, seasonalworkextension, europeanpermits, citizenships, brexitpermits, residencepermitcardrenewalinitialpage, temporaryprotectionextensioninformation, help. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-enterfinland-fi-api-b5f9799c/get_page_content \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language":"<string>","page_slug":"<string>"}'
```

### list_permit_categories

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `language` | string | No | Language for content. Determines the language of returned category names and descriptions. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-enterfinland-fi-api-b5f9799c/list_permit_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language":"<string>"}'
```