# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/enterfinland/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/enterfinland/get-help-topics \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/enterfinland/get-page-content \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/enterfinland/list-permit-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"language":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.