> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topograph.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Sweden

> Country-specific identifiers, data sources, and implementation details

## Start here

This guide contains public integration notes for Sweden. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.

<Card title="Sweden coverage, pricing, and sources" icon="arrow-up-right-from-square" href="https://topograph.co/pricing/se">
  Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
</Card>

<Note>
  Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.
</Note>

## Table of Contents

* [Data Sources](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Quirks & Gotchas](#quirks--gotchas)
* [Mappings](#mappings)
* [Data Availability](#data-availability)
* [Example API Responses](#example-api-responses)

## Data Sources

All company data is sourced from **Bolagsverket** (Swedish Companies Registration Office), the official government agency responsible for registering companies, partnerships, associations, and other legal entities in Sweden. Bolagsverket was established in 2004 when it took over registration duties from the Patent and Registration Office (PRV).

For a given entity, **data comes from a single source** -- there is no cross-registry merging. Two Bolagsverket API versions are used for different purposes:

* **Bolagsverket Foretagsinformation API v4** -- The **primary source** for company profile data. This is a paid API that provides comprehensive structured data: company name, legal form, status, registration and incorporation dates, registered address, share capital, activity description, board members and officers (funktionarer), signing rules (firmateckning), financial reporting periods, and articles of association details. Used for the `companyProfile` data point.

* **Bolagsverket Vardefulla Datamangder API v1** -- A free open data API providing basic company information. Used for **search by registration number** and for **annual report document listings** (dokumentlista endpoint). Returns: company name, legal form, address, registration date, and status indicators. Also provides the annual reports document listing for each company.

* **Bolagsverket Foretagsinfo Website API** -- The Bolagsverket public website (`foretagsinfo.bolagsverket.se`) exposes a product catalog API that lists available **purchasable documents** per company. This is used to determine which paid documents (trade register extract, articles of association, statutes, minutes, UBO extract, current assignments) are available for a given company and legal form.

<Note>
  **Search by company name** is retrieved from the official registry because the Bolagsverket name search functionality does not have a public REST API endpoint. Identifier-based searches use the v1 API directly.
</Note>

### Ultimate Beneficial Owners

UBO data is obtained by retrieving the **UBO Extract** (Registret over verkliga huvudman) document from Bolagsverket's website, then parsing the PDF content with AI. Bolagsverket does not yet expose UBO data through a structured API endpoint.

## Company Identifiers

### Query Identifiers

| Identifier Type         | Format                                        | Example                              | Notes                                                                                                            |
| ----------------------- | --------------------------------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
| **Organisationsnummer** | 10 digits (`NNNNNN-NNNN` or `NNNNNNNNNN`)     | `5560125790` or `556012-5790`        | Primary identifier for companies. Hyphen is optional.                                                            |
| **Personnummer**        | 12 digits (`YYYYMMDDNNNN` or `YYYYMMDD-NNNN`) | `196405250314` or `19640525-0314`    | Used by sole traders (enskild firma). Issued by Skatteverket. Hyphen is optional.                                |
| **VAT number**          | `SE` + 12 digits                              | `SE556012579001` or `SE640525031401` | Companies: SE + organisationsnummer + `01`. Sole traders: SE + century-stripped personnummer (10 digits) + `01`. |

<Tip>
  **Organisationsnummer vs personnummer:** Organisation numbers have digits 3-4 (the "month" position) >= 20, distinguishing them from personnummers where those digits are 01-12 (a real birth month). For example, `556012-5790` has "60" in positions 3-4 — an organisation number. `196405250314` has "64" — a personnummer. The search request handles both automatically.
</Tip>

### Identifiers in API Response

| Identifier               | Format                      | Example        | Notes                                                              |
| ------------------------ | --------------------------- | -------------- | ------------------------------------------------------------------ |
| `id`                     | 10 or 12 digits (no hyphen) | `5560125790`   | For companies: 10 digits. For sole traders: 12-digit personnummer. |
| `registrationNumber`     | 10 digits                   | `5560125790`   | Returned for companies only.                                       |
| `personalIdentityNumber` | 12 digits                   | `196405250314` | Returned for sole traders instead of `registrationNumber`.         |

## Search Capabilities

| Search Type            | Pattern                            | Example                           | Match Type | Expected Results                                                     |
| ---------------------- | ---------------------------------- | --------------------------------- | ---------- | -------------------------------------------------------------------- |
| By Organisationsnummer | 10 digits (with or without hyphen) | `5560125790` or `556012-5790`     | Exact      | Exact match returned first (matchType: id); other results may follow |
| By Personnummer        | 12 digits (with or without hyphen) | `196405250314` or `19640525-0314` | Exact      | Exact match returned first (matchType: id); other results may follow |
| By VAT number          | `SE` + 12 digits                   | `SE556012579001`                  | Exact      | Exact match returned first (matchType: id); other results may follow |
| By company name        | Text string                        | `"Volvo"`                         | Contains   | Multiple results                                                     |

<Info>
  **Identifier normalization:** The search request strips the `SE` prefix and trailing digits from VAT numbers, removes hyphens from organisation numbers and personnummers, and detects sole traders automatically by the personnummer format (12 digits, birth-month digits 01-12 in positions 3-4).
</Info>

<Note>
  **Search uses both a live registry lookup and an official registry query.** Identifier searches (organisationsnummer, VAT) query the Bolagsverket v1 API directly. Name searches query the official registry because no public name search API exists.
</Note>

## Quirks & Gotchas

| Quirk                                                        | Details                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Sole traders use personnummer as identifier**              | Sole traders (enskild firma) are registered at Bolagsverket with their personal identity number (personnummer, 12 digits YYYYMMDDNNNN) instead of an organisationsnummer. Pass the personnummer directly as the identifier. The response returns `personalIdentityNumber` in `identifiers` and omits company-specific fields like share capital and board members.                                                                                     |
| **Natural persons return `notFound` on company profile**     | A personnummer that belongs to a natural person with no registered business at Bolagsverket returns `resource_not_found` on the `company` datapoint. This is distinct from a registered sole trader (enskild firma) with the same personnummer format but an active Bolagsverket registration. Natural persons can still have purchasable documents (current assignments, prohibition register, insolvency register).                                  |
| **Shareholders come from the annual report, when disclosed** | Bolagsverket does not publish a share register: ownership is restricted to authorities and the company's own shareholders. Some annual reports voluntarily disclose ownership in the ownership note, and that is what the `shareholders` datapoint reads. Disclosure is not required, so most companies return none. Sole traders (enskild firma) have no share capital at all, so the datapoint returns an explicit not-applicable response for them. |
| **UBO = control extent, not ownership**                      | Bolagsverket reports **control extent** (Omfattning) for UBOs, not ownership percentage. Multiple UBOs can each show 100% control. This reflects influence over the company through shares, agreements, or intermediary entities -- not economic stake.                                                                                                                                                                                                |
| **All activity codes are AI-inferred**                       | Sweden does not assign standard classification codes. The `verksamhetsbeskrivning` (activity description) is a free-text field in Swedish, and all ISIC/NACE codes are derived by AI. `isAIInferred` is always `true`.                                                                                                                                                                                                                                 |
| **Active = empty status array**                              | An active company has an **empty** `organisationsstatusar` array from Bolagsverket. Any status entry means the company is inactive. This is the opposite of most registries which explicitly mark companies as active.                                                                                                                                                                                                                                 |
| **Status code system is complex**                            | Bolagsverket uses dozens of numeric status codes across two categories: `AvregistreradOrganisationstyp` (struck off the register -- codes 21, 31, 37, 41, 51, 53, 60-64, 70, 73, 74, 91, 98) and `AvvecklingsOmstruktureringsforfarande` (ongoing settlement/restructuring -- codes 11, 20, 32, 45, 49, 75, 80, 85, 90, 91, 96).                                                                                                                       |
| **All documents are in Swedish**                             | All documents from Bolagsverket (annual reports, trade register extracts, articles of association, UBO extract, etc.) are written in Swedish. English certificates require login and are not available programmatically.                                                                                                                                                                                                                               |
| **Annual reports: API vs purchasable**                       | Annual reports come from two sources: (1) free individual filings via the v1 API dokumentlista endpoint (ZIP format containing original filing), and (2) a paid compilation of all years from the website (single PDF).                                                                                                                                                                                                                                |
| **Legal form is AI-enriched**                                | Local Swedish legal forms are deterministically mapped to English translations via a static codelist. However, the `standardized` form and `iso20275Code` are AI-enriched.                                                                                                                                                                                                                                                                             |
| **Share capital in SEK only**                                | Share capital for AB companies is always denominated in Swedish Kronor (SEK).                                                                                                                                                                                                                                                                                                                                                                          |
| **Purchasable documents vary by legal form**                 | The available purchasable documents depend on the company's legal form code. For example, "Articles of Association" (Bolagsordning) applies to AB companies, while "Statutes" (Stadgar) applies to associations.                                                                                                                                                                                                                                       |
| **Document retrieve requires retrieval flow**                | Purchasable documents involve a 5-step process: temporary inbox creation, website retrieval, document download, PDF extraction from ZIP, and invoice forwarding. Delivery takes approximately 5 minutes.                                                                                                                                                                                                                                               |

## Mappings

### Company Status

Status is determined **deterministically** from the Bolagsverket register. An empty `organisationsstatusar` array means the company is active. Any status entry triggers mapping through the status code system.

#### Active Status

| Local Status | English Translation | Standardized Status |
| ------------ | ------------------- | ------------------- |
| Aktiv        | Active              | `ACTIVE`            |

<Note>
  "Aktiv" is not returned by the API -- it is inferred from the absence of any status entries. When `organisationsstatusar` is empty or undefined, the company is considered active.
</Note>

#### Struck-Off Statuses (AvregistreradOrganisationstyp)

| Code | Swedish Name                                                 | English Translation                                | Standardized Status           | Closure Reason          |
| ---- | ------------------------------------------------------------ | -------------------------------------------------- | ----------------------------- | ----------------------- |
| 21   | Konkurs                                                      | Bankruptcy (struck off)                            | `UNDER_INSOLVENCY_PROCEEDING` | `BANKRUPTCY`            |
| 31   | Likvidation                                                  | Liquidation (struck off)                           | `UNDER_INSOLVENCY_PROCEEDING` | `LIQUIDATION`           |
| 37   | Ombildat till bankaktiebolag eller aktiekapitalet inte hojts | Converted to banking company or capital not raised | `CLOSED`                      | `OTHER`                 |
| 41   | Fusion                                                       | Merger (struck off)                                | `CLOSED`                      | `MERGER`                |
| 51   | Overksamhet                                                  | Inactivity                                         | `CLOSED`                      | `VOLUNTARY_DISSOLUTION` |
| 53   | Ny innehavare                                                | New owner                                          | `CLOSED`                      | `OTHER`                 |
| 60   | Det utlandska foretagets likvidation eller konkurs           | Foreign company liquidation or bankruptcy          | `CLOSED`                      | `OTHER`                 |
| 61   | Verksamheten har upphort                                     | Operations ceased                                  | `CLOSED`                      | `VOLUNTARY_DISSOLUTION` |
| 62   | Verkstallande direktor saknas                                | Missing CEO                                        | `CLOSED`                      | `OTHER`                 |
| 63   | Beslut av instans                                            | Decision by authority                              | `CLOSED`                      | `OTHER`                 |
| 64   | Arsredovisning saknas                                        | Missing annual report                              | `CLOSED`                      | `OTHER`                 |
| 70   | Aktiekapitalet inte hojts                                    | Share capital not raised                           | `CLOSED`                      | `OTHER`                 |
| 73   | Avregistrerad                                                | Deregistered                                       | `CLOSED`                      | `OTHER`                 |
| 74   | Ombildat till bankaktiebolag                                 | Converted to banking company                       | `CLOSED`                      | `OTHER`                 |
| 91   | Delning                                                      | Division/split                                     | `CLOSED`                      | `OTHER`                 |
| 98   | Gransoverskridande ombildning                                | Cross-border transformation (struck off)           | `CLOSED`                      | `OTHER`                 |

#### Ongoing Procedure Statuses (AvvecklingsOmstruktureringsforfarande)

| Code | Swedish Name                  | English Translation                   | Standardized Status           | Closure Reason |
| ---- | ----------------------------- | ------------------------------------- | ----------------------------- | -------------- |
| 11   | Ackordsforhandling            | Composition proceedings               | `UNDER_INSOLVENCY_PROCEEDING` | --             |
| 20   | Konkurs                       | Bankruptcy (ongoing)                  | `UNDER_INSOLVENCY_PROCEEDING` | `BANKRUPTCY`   |
| 32   | Likvidation                   | Liquidation (ongoing)                 | `UNDER_INSOLVENCY_PROCEEDING` | `LIQUIDATION`  |
| 45   | Overlatande i fusion          | Transferring in merger (ongoing)      | `CLOSED`                      | `MERGER`       |
| 49   | Overtagande i fusion          | Acquiring in merger (ongoing)         | `CLOSED`                      | `MERGER`       |
| 75   | Ombildning                    | Transformation (ongoing)              | `CLOSED`                      | `OTHER`        |
| 80   | Foretagsrekonstruktion        | Corporate restructuring               | `UNDER_INSOLVENCY_PROCEEDING` | --             |
| 85   | Resolution                    | Resolution (banking/financial sector) | `UNDER_INSOLVENCY_PROCEEDING` | --             |
| 90   | Overlatande vid delning       | Transferring in division              | `CLOSED`                      | `OTHER`        |
| 96   | Gransoverskridande ombildning | Cross-border transformation (ongoing) | `CLOSED`                      | `OTHER`        |

### Legal Forms

The local legal form (`organisationsform.klartext`) is preserved from Bolagsverket and deterministically mapped to an English translation. The `standardized` form and `iso20275Code` are **AI-enriched**.

#### Key Business Forms

| Code | Swedish Name              | English Translation     | ISO 20275 |
| ---- | ------------------------- | ----------------------- | --------- |
| AB   | Aktiebolag                | Private Limited Company | `XJHM`    |
| Publ | Publikt aktiebolag        | Public Limited Company  | -         |
| HB   | Handelsbolag              | General Partnership     | `BEAY`    |
| KB   | Kommanditbolag            | Limited Partnership     | -         |
| EK   | Ekonomisk forening        | Economic Association    | `C61P`    |
| E    | Enskild naringsverksamhet | Sole Proprietorship     | -         |
| EB   | Enkla bolag               | Simple Company          | -         |

#### Housing and Cooperative Forms

| Code | Swedish Name                  | English Translation            | ISO 20275 |
| ---- | ----------------------------- | ------------------------------ | --------- |
| BRF  | Bostadsrattsforening          | Housing Cooperative            | -         |
| BF   | Bostadsforening               | Housing Association            | -         |
| KHF  | Kooperativ hyresrattsforening | Cooperative Rental Association | -         |
| SF   | Sambruksforening              | Joint Use Association          | -         |

#### Non-Profits and Foundations

| Code | Swedish Name                                   | English Translation    | ISO 20275 |
| ---- | ---------------------------------------------- | ---------------------- | --------- |
| I    | Ideell forening som bedriver naringsverksamhet | Non-profit Association | -         |
| S    | Stiftelse som bedriver naringsverksamhet       | Foundation             | -         |
| TSF  | Trossamfund som bedriver naringsverksamhet     | Religious Community    | -         |

#### Financial Institutions

| Code | Swedish Name                    | English Translation                 | ISO 20275 |
| ---- | ------------------------------- | ----------------------------------- | --------- |
| BAB  | Bankaktiebolag                  | Banking Company                     | -         |
| FAB  | Forsakringsaktiebolag           | Insurance Company                   | -         |
| SB   | Sparbank                        | Savings Bank                        | -         |
| MB   | Medlemsbank                     | Member Bank                         | -         |
| OFB  | Omsesidigt forsakringsbolag     | Mutual Insurance Company            | -         |
| OTPB | Omsesidigt tjanstepensionsbolag | Mutual Occupational Pension Company | -         |
| TPAB | Tjanstepensionsaktiebolag       | Occupational Pension Company        | -         |
| TPF  | Tjanstepensionsforening         | Occupational Pension Association    | -         |
| FOF  | Forsakringsforening             | Insurance Association               | -         |
| FF   | Forsakringsformedlare           | Insurance Broker                    | -         |

#### Branch Offices and European Forms

| Code | Swedish Name                                        | English Translation                          | ISO 20275 |
| ---- | --------------------------------------------------- | -------------------------------------------- | --------- |
| FL   | Filial                                              | Branch Office                                | -         |
| BFL  | Utlandsk banks filial                               | Foreign Bank Branch                          | -         |
| SE   | Europabolag                                         | European Company (Societas Europaea)         | -         |
| SCE  | Europakooperativ                                    | European Cooperative Society                 | -         |
| EEIG | Europeisk ekonomisk intressegruppering              | European Economic Interest Grouping          | -         |
| EGTS | Europeiska grupperingar for territoriellt samarbete | European Grouping of Territorial Cooperation | -         |

#### Legacy and Other Forms

| Code                | Swedish Name        | English Translation   | ISO 20275 |
| ------------------- | ------------------- | --------------------- | --------- |
| Konkursbo           | Konkursbo           | Bankruptcy Estate     | -         |
| Kreditmarknadsbolag | Kreditmarknadsbolag | Credit Market Company | -         |
| Vardepappersbolag   | Vardepappersbolag   | Securities Company    | -         |

<Note>
  Bolagsverket maintains approximately 30 standardized legal form codes. The `iso20275Code` is AI-enriched and available for common forms like AB (`XJHM`), HB (`BEAY`), and EK (`C61P`). Additional legacy forms may appear in historical records. The API preserves the `localName` exactly as returned by Bolagsverket.
</Note>

### Legal Representatives

These roles have statutory authority to bind the company and are classified as legal representatives. Role codes are from the official Bolagsverket funktionarsroller codelist. Roles are **deterministically mapped** to English translations; the `iso5009Code` is **AI-enriched**.

| Code | Swedish Name           | English Translation | Standardized   |
| ---- | ---------------------- | ------------------- | -------------- |
| OF   | Styrelseordforande     | Chairman            | `Chairman`     |
| VD   | Verkstallande direktor | CEO                 | `CEO`          |
| LE   | Styrelseledamot        | Board Member        | `Board Member` |
| SU   | Styrelsesuppleant      | Deputy Board Member | `Board Member` |
| SUPP | Suppleant              | Deputy Board Member | `Board Member` |

<Info>
  **Role priority:** When a person holds multiple roles, the system applies a priority: OF (Chairman) > VD (CEO) > LE (Board Member) > SU/SUPP (Deputy). Only the highest-priority role is assigned as the legal representative role for that person.
</Info>

### Other Key Persons

All other officer roles (funktionarer) are classified as other key persons. **Both individuals and corporate entities** can hold these roles (e.g., an auditing firm as auditor). Role codes are standardized by Bolagsverket.

#### Executive Management Roles

| Code | Swedish Name                             | English Translation     | Standardized      |
| ---- | ---------------------------------------- | ----------------------- | ----------------- |
| EVD  | Verkstallande direktor                   | Chief Executive Officer | `CLevelExecutive` |
| VVD  | Vice verkstallande direktor              | Vice CEO                | `CLevelExecutive` |
| EVVD | Vice verkstallande direktor              | Vice CEO                | `CLevelExecutive` |
| SVD  | Stallforetradande verkstallande direktor | Deputy CEO              | `CLevelExecutive` |
| VLE  | Verkstallande ledamot                    | Managing Director       | `CLevelExecutive` |

#### Auditor Roles

| Code  | Swedish Name                             | English Translation                     | Standardized |
| ----- | ---------------------------------------- | --------------------------------------- | ------------ |
| REV   | Revisor                                  | Auditor                                 | `Auditor`    |
| REVT  | Revisor (med tillstand)                  | Auditor (with authorization)            | `Auditor`    |
| REVH  | Huvudansvarig revisor                    | Principal Auditor                       | `Auditor`    |
| REVS  | Revisorssuppleant                        | Deputy Auditor                          | `Auditor`    |
| REVST | Revisorssuppleant (med tillstand)        | Deputy Auditor (with authorization)     | `Auditor`    |
| REVL  | Lekmannarevisor                          | Lay Auditor                             | `Auditor`    |
| REVSL | Suppleant for lekmannarevisor            | Deputy Lay Auditor                      | `Auditor`    |
| HREV  | Revisor hallbarhetsrapport               | Sustainability Report Auditor           | `Auditor`    |
| HREVH | Huvudansvarig revisor hallbarhetsrapport | Principal Sustainability Report Auditor | `Auditor`    |
| HREVS | Revisorssuppleant hallbarhetsrapport     | Deputy Sustainability Report Auditor    | `Auditor`    |

#### Signatory and Representative Roles

| Code | Swedish Name         | English Translation  | Standardized        |
| ---- | -------------------- | -------------------- | ------------------- |
| PO   | Prokurist            | Authorized Signatory | `Other`             |
| EFT  | Extern firmatecknare | External Signatory   | `Other`             |
| REP  | Representant         | Representative       | `Other`             |
| DELG | Delgivningsmottagare | Service Agent        | `ComplianceOfficer` |

#### Partnership Roles

| Code | Swedish Name      | English Translation | Standardized |
| ---- | ----------------- | ------------------- | ------------ |
| BO   | Bolagsman         | Partner             | `Other`      |
| KP   | Komplementar      | General Partner     | `Other`      |
| KD   | Kommanditdelagare | Limited Partner     | `Other`      |

#### Other Administrative Roles

| Code | Swedish Name                 | English Translation         | Standardized |
| ---- | ---------------------------- | --------------------------- | ------------ |
| IN   | Enskild naringsidkare        | Sole Proprietor             | `Other`      |
| FO   | Forestandare                 | Director                    | `Other`      |
| FV   | Forvaltare                   | Administrator               | `Other`      |
| LI   | Likvidator                   | Liquidator                  | `Other`      |
| LS   | Likvidatorssuppleant         | Deputy Liquidator           | `Other`      |
| AK   | Aktuarie                     | Actuary                     | `Secretary`  |
| ARB  | Arbetstagarrepresentant      | Employee Representative     | `Supervisor` |
| FTR  | Forsakringstagarrepresentant | Policyholder Representative | `Supervisor` |

<Note>
  A person or entity can hold **multiple roles simultaneously**. For legal representatives, the highest-priority role is selected. For other key persons, each non-legal-representative role is listed separately. When an organization holds a role (e.g., an auditing firm), its representative person is also listed with the suffix "(Representative)".
</Note>

### Shareholders

Bolagsverket does **not** publish a share register. Ownership is restricted to authorities and the company's own shareholders, so there is no register source for it.

What the `shareholders` datapoint reads instead is the **ownership note in the company's annual report**. Swedish companies are not required to disclose ownership there, so most return none. Names and holdings are extracted by AI from the filing, so verify against the source before relying on them for compliance.

Sole traders (enskild firma) have no share capital, so the datapoint does not apply to them at all: it returns an explicit `datapoint_not_applicable` response and the owner is returned under `legalRepresentatives`. See [Sole Entrepreneurs & Non-Profits](/essentials/entity-types).

### Activity Code Mapping

Sweden does **not** use a national activity code classification in the Bolagsverket registry. Instead, companies register a free-text **verksamhetsbeskrivning** (activity description) in Swedish. The system uses AI enrichment to derive standardized activity codes:

```
Verksamhetsbeskrivning (Swedish free text) --> AI --> ISIC Rev. 4 + NACE Rev. 2
```

| Classification           | Source                                  | Example                                     | AI Inferred?  |
| ------------------------ | --------------------------------------- | ------------------------------------------- | ------------- |
| **Activity description** | Bolagsverket (`verksamhetsbeskrivning`) | "Utveckling och forsaljning av programvara" | No (official) |
| **ISIC**                 | AI-derived from activity description    | `6201` - Computer programming activities    | Yes (always)  |
| **NACE**                 | AI-derived from activity description    | `62.01` - Computer programming activities   | Yes (always)  |

<Note>
  **All ISIC and NACE codes for Sweden are AI-inferred** because Bolagsverket does not assign standard classification codes. The AI derives codes from the Swedish-language activity description text. The `isAIInferred` flag is always `true` for Swedish activity codes.
</Note>

## Data Availability

### Data Availability Matrix

| Data Type             | AB (Private Ltd) | E (Sole Prop.) | HB/KB (Partnerships) | I (Non-profit) | S (Foundation) | Notes                                          |
| --------------------- | ---------------- | -------------- | -------------------- | -------------- | -------------- | ---------------------------------------------- |
| Company Profile       | Yes              | Yes            | Yes                  | Yes            | Yes            | Full data from Bolagsverket v4 API             |
| Legal Representatives | Yes              | Limited        | Yes                  | Yes            | Yes            | Board members, CEO, signatories                |
| Other Key Persons     | Yes              | Limited        | Yes                  | Yes            | Yes            | Auditors, deputies, partners, etc.             |
| Shareholders          | No               | No             | No                   | No             | No             | Not available from Bolagsverket                |
| UBOs                  | Yes              | No             | Limited              | Limited        | Limited        | Via retrieved UBO extract document (AI-parsed) |
| Activity Codes        | Yes              | Yes            | Yes                  | Yes            | Yes            | AI-inferred from description (always)          |
| Share Capital         | Yes              | No             | No                   | No             | No             | AB companies only, always in SEK               |
| Employee Count        | No               | No             | No                   | No             | No             | Not available from Bolagsverket                |

### Documents by Company Type

#### Free Documents (API)

| Document                                   | Format | Source                              | Notes                                                       |
| ------------------------------------------ | ------ | ----------------------------------- | ----------------------------------------------------------- |
| Annual Report (individual filing per year) | ZIP    | Bolagsverket v1 API (dokumentlista) | Contains original filing format. Sorted by year descending. |

#### Purchasable Documents (Website)

| Document                            | Bolagsverket Code | Format | Applicable Legal Forms                        | Notes                                                          |
| ----------------------------------- | ----------------- | ------ | --------------------------------------------- | -------------------------------------------------------------- |
| Certified Trade Register Extract    | REGBEV            | PDF    | All registered entities                       | Official extract with company status and registration details  |
| Articles of Association             | BOLORDN           | PDF    | AB, BAB, FAB, SE                              | Business activities, registered office, share capital rules    |
| Statutes                            | STADG             | PDF    | EK, BRF, I, S, and associations               | Governing rules for non-AB entities                            |
| Annual Reports (compilation)        | ARSRED            | PDF    | All that file reports                         | Combined annual reports across all filing years                |
| Minutes                             | PROT              | PDF    | All registered entities                       | Board meeting or general meeting minutes                       |
| Ultimate Beneficial Owners Extract  | RVHBEV            | PDF    | All with UBO registration                     | UBO information from Bolagsverket register                     |
| Current Assignments                 | AKTUPPD           | PDF    | All (registered entities and natural persons) | Current assignments in other entities                          |
| Current and Previous Assignments    | HISTUPPD          | PDF    | Natural persons (personnummer)                | Current and historical assignments                             |
| Business Prohibition Register       | NFBEV             | PDF    | Natural persons (personnummer)                | Whether or not a person has a prohibition to carry on business |
| Insolvency Register of Bankruptcies | PPKKBEV           | PDF    | Natural persons (personnummer)                | Whether or not a person is in bankruptcy                       |

<Note>
  **Historical Certificates** (HISTBEV) and **English Certificates** (ENGINTYG) require authenticated login to Bolagsverket and are not available programmatically. The available purchasable documents vary by legal form and entity type. The system automatically queries the correct document catalog.
</Note>

<Warning>
  **Purchasable documents involve real retrieval.** Each document retrieve triggers a retrieval flow through Bolagsverket's website. Document delivery takes approximately 5 minutes due to the retrieval, download, and processing steps.
</Warning>

### Example API Responses

All examples use **placeholder data**. Real personal names have been replaced with fictional ones.

<AccordionGroup>
  <Accordion title="Active AB (Private Limited Company)">
    ```json theme={null}
    {
      "company": {
        "id": "5560001234",
        "countryCode": "SE",
        "legalName": "Nordisk Teknik AB",
        "registrationDate": "2018-03-15",
        "incorporationDate": "2018-02-01",
        "status": {
          "localName": "Aktiv",
          "active": true,
          "statusDetails": {
            "status": "ACTIVE"
          }
        },
        "legalForm": {
          "localName": "Aktiebolag",
          "englishTranslation": "Private Limited Company",
          "standardized": "Corporation",
          "iso20275Code": "XJHM"
        },
        "capital": {
          "amount": 50000,
          "currency": "SEK",
          "formatted": "50 000 SEK"
        },
        "activityDescription": "Bolaget skall bedriva utveckling och forsaljning av programvara for industriell automation samt darmed forenlig verksamhet.",
        "activities": {
          "ISIC": [{ "code": "6201", "description": "Computer programming activities", "isAIInferred": true }],
          "NACE": [{ "code": "62.01", "description": "Computer programming activities", "isAIInferred": true }]
        },
        "legalAddress": {
          "addressLine1": "10 Storgatan",
          "city": "Stockholm",
          "postalCode": "111 22",
          "countryCode": "SE",
          "state": "Stockholms lan"
        }
      },
      "legalRepresentatives": [
        {
          "type": "individual",
          "role": { "localName": "Styrelseordforande", "englishTranslation": "Chairman", "standardized": "Chairman", "iso5009Code": "3NXF5M" },
          "individual": { "name": { "firstName": "Erik", "lastName": "Lindberg", "fullName": "Erik Johan Lindberg" }, "residenceAddress": { "addressLine1": "5 Vasagatan", "city": "Stockholm", "postalCode": "111 20", "countryCode": "SE" } }
        },
        {
          "type": "individual",
          "role": { "localName": "Verkstallande direktor", "englishTranslation": "CEO", "standardized": "CEO", "iso5009Code": "3NXF5L" },
          "individual": { "name": { "firstName": "Sara", "lastName": "Johansson", "fullName": "Sara Maria Johansson" }, "residenceAddress": { "addressLine1": "12 Drottninggatan", "city": "Stockholm", "postalCode": "111 51", "countryCode": "SE" } }
        },
        {
          "type": "individual",
          "role": { "localName": "Styrelseledamot", "englishTranslation": "Board Member", "standardized": "Board Member", "iso5009Code": "AVPA" },
          "individual": { "name": { "firstName": "Anders", "lastName": "Nilsson", "fullName": "Anders Per Nilsson" }, "residenceAddress": { "addressLine1": "3 Kungsgatan", "city": "Gothenburg", "postalCode": "411 19", "countryCode": "SE" } }
        }
      ],
      "otherKeyPersons": [
        {
          "type": "company",
          "role": { "localName": "Revisor", "englishTranslation": "Auditor", "standardized": "Auditor" },
          "company": { "id": "5560030674", "legalName": "Revisionsfirman Exemplet AB", "countryCode": "SE", "legalAddress": { "city": "Stockholm", "countryCode": "SE" } }
        },
        {
          "type": "individual",
          "role": { "localName": "Revisor (Representant)", "englishTranslation": "Auditor (Representative)", "standardized": "Auditor" },
          "individual": { "name": { "firstName": "Lars", "lastName": "Persson", "fullName": "Lars Henrik Persson" } }
        }
      ],
      "shareholders": []
    }
    ```
  </Accordion>

  <Accordion title="Closed AB (Merger)">
    ```json theme={null}
    {
      "company": {
        "id": "5564321000",
        "countryCode": "SE",
        "legalName": "Gammal Industri Aktiebolag",
        "registrationDate": "1989-07-25",
        "incorporationDate": "1989-04-28",
        "status": {
          "localName": "Fusion",
          "active": false,
          "statusDetails": {
            "status": "CLOSED",
            "closureReason": "MERGER",
            "closureDate": "2006-01-02",
            "additionalInfo": "Status code: 41"
          }
        },
        "legalForm": {
          "localName": "Aktiebolag",
          "englishTranslation": "Private Limited Company",
          "standardized": "Corporation",
          "iso20275Code": "XJHM"
        },
        "capital": {
          "amount": 100000,
          "currency": "SEK",
          "formatted": "100 000 SEK"
        },
        "activityDescription": "Bolaget skall avse handel och fabriksrorelse betraffande mekaniska verkstadsprodukter, sasom entreprenadmaskiner och fordon.",
        "activities": {
          "ISIC": [{ "code": "2829", "description": "Manufacture of other general-purpose machinery n.e.c.", "isAIInferred": true }]
        },
        "legalAddress": {
          "addressLine1": "Carl Lihnells vag",
          "city": "Braas",
          "postalCode": "363 41",
          "countryCode": "SE",
          "state": "Kronobergs lan"
        }
      },
      "legalRepresentatives": [
        {
          "type": "individual",
          "role": { "localName": "Styrelseordforande", "englishTranslation": "Chairman", "standardized": "Chairman", "iso5009Code": "3NXF5M" },
          "individual": { "name": { "firstName": "Karl", "lastName": "Svensson", "fullName": "Karl Anders Svensson" } }
        },
        {
          "type": "individual",
          "role": { "localName": "Verkstallande direktor", "englishTranslation": "CEO", "standardized": "CEO", "iso5009Code": "BF3W0F" },
          "individual": { "name": { "firstName": "Gustaf", "lastName": "Rosen", "fullName": "Gustaf Yngve Rosen" } }
        }
      ],
      "otherKeyPersons": [
        {
          "type": "individual",
          "role": { "localName": "Arbetstagarrepresentant", "englishTranslation": "Employee Representative", "standardized": "Supervisor" },
          "individual": { "name": { "firstName": "Bengt", "lastName": "Larsson", "fullName": "Bengt Liss-Erik Larsson" } }
        },
        {
          "type": "company",
          "role": { "localName": "Revisor", "englishTranslation": "Auditor", "standardized": "Auditor" },
          "company": { "id": "5560674276", "legalName": "Revisionsfirman Exemplet AB", "countryCode": "SE" }
        }
      ],
      "shareholders": []
    }
    ```

    **Note:** Closed companies have `active: false`. The `closureReason` reflects the Bolagsverket status code -- code 41 = Fusion (Merger).
  </Accordion>

  <Accordion title="Handelsbolag (General Partnership)">
    ```json theme={null}
    {
      "company": {
        "id": "9691234567",
        "countryCode": "SE",
        "legalName": "Lindberg & Eriksson Handelsbolag",
        "registrationDate": "2007-07-02",
        "status": {
          "localName": "Anmalan om att verksamheten har upphort",
          "active": false,
          "statusDetails": {
            "status": "CLOSED",
            "closureReason": "VOLUNTARY_DISSOLUTION",
            "closureDate": "2010-07-05",
            "additionalInfo": "Status code: 61"
          }
        },
        "legalForm": {
          "localName": "Handelsbolag",
          "englishTranslation": "General Partnership",
          "standardized": "Partnership",
          "iso20275Code": "BEAY"
        },
        "activityDescription": "Foremal for bolagets verksamhet ar samarbete inom affarsomradet tillverkning och forsaljning av utrustning.",
        "activities": {
          "ISIC": [{ "code": "2910", "description": "Manufacture of motor vehicles", "isAIInferred": true }]
        },
        "legalAddress": {
          "city": "Gothenburg",
          "countryCode": "SE",
          "state": "Vastra Gotaland County"
        }
      },
      "legalRepresentatives": [],
      "otherKeyPersons": [
        {
          "type": "company",
          "role": { "localName": "Bolagsman", "englishTranslation": "Partner", "standardized": "Other" },
          "company": { "id": "5565399853", "legalName": "Nordisk Holding Aktiebolag", "countryCode": "SE" }
        },
        {
          "type": "company",
          "role": { "localName": "Bolagsman", "englishTranslation": "Partner", "standardized": "Other" },
          "company": { "id": "5560139700", "legalName": "Transport Sverige Aktiebolag", "countryCode": "SE" }
        },
        {
          "type": "individual",
          "role": { "localName": "Extern firmatecknare", "englishTranslation": "External Signatory", "standardized": "Other" },
          "individual": { "name": { "firstName": "Henrik", "lastName": "Bergstrom", "fullName": "Henrik Bergstrom" } }
        },
        {
          "type": "individual",
          "role": { "localName": "Revisor", "englishTranslation": "Auditor", "standardized": "Auditor" },
          "individual": { "name": { "firstName": "Rolf", "lastName": "Karlsson", "fullName": "Rolf Olov Anders Karlsson" } }
        }
      ],
      "shareholders": []
    }
    ```

    **Note:** Partnerships (HB/KB) list partners (`Bolagsman`) as other key persons, not as legal representatives. No share capital is registered for partnerships.
  </Accordion>

  <Accordion title="Enskild naringsverksamhet (Sole Proprietorship)">
    ```json theme={null}
    {
      "company": {
        "id": "196405250314",
        "countryCode": "SE",
        "legalName": "Bergkvist Textil",
        "registrationDate": "2003-06-12",
        "status": {
          "localName": "Aktiv",
          "active": true,
          "statusDetails": {
            "status": "ACTIVE"
          }
        },
        "legalForm": {
          "localName": "Enskild naringsverksamhet",
          "englishTranslation": "Sole Proprietorship",
          "standardized": "Sole Proprietorship"
        },
        "activityDescription": "Handel med textil och tillbehor samt darmed forenlig verksamhet.",
        "activities": {
          "ISIC": [{ "code": "4751", "description": "Retail sale of textiles in specialised stores", "isAIInferred": true }]
        },
        "legalAddress": {
          "addressLine1": "7 Lindgatan",
          "city": "Vasteras",
          "postalCode": "722 15",
          "countryCode": "SE",
          "state": "Vastmanlands lan"
        }
      },
      "identifiers": {
        "personalIdentityNumber": "196405250314",
        "VAT": "640525031401"
      },
      "legalRepresentatives": [
        {
          "type": "individual",
          "role": {
            "localName": "Enskild naringsidkare",
            "englishTranslation": "Sole Proprietor",
            "standardized": "Other"
          },
          "individual": {
            "name": { "firstName": "Anna", "lastName": "Bergkvist", "fullName": "Anna Bergkvist" },
            "residenceAddress": { "city": "Vasteras", "countryCode": "SE" }
          }
        }
      ],
      "otherKeyPersons": [],
      "shareholders": []
    }
    ```

    **Note:** Sole traders return `personalIdentityNumber` in `identifiers` instead of `registrationNumber`. The `id` field holds the 12-digit personnummer. Share capital, board members, and signing rules are not present — they are company-specific fields that do not apply to sole proprietorships.
  </Accordion>

  <Accordion title="Ekonomisk forening (Economic Association / Cooperative)">
    ```json theme={null}
    {
      "company": {
        "id": "7180004926",
        "countryCode": "SE",
        "legalName": "Personalforeningen vid Norrlands Maskiner, ekonomisk forening",
        "registrationDate": "1974-12-06",
        "status": {
          "localName": "Likvidation",
          "active": false,
          "statusDetails": {
            "status": "UNDER_INSOLVENCY_PROCEEDING",
            "closureReason": "LIQUIDATION",
            "closureDate": "2011-04-27",
            "additionalInfo": "Status code: 31"
          }
        },
        "legalForm": {
          "localName": "Ekonomisk forening",
          "englishTranslation": "Economic Association",
          "standardized": "Cooperative",
          "iso20275Code": "C61P"
        },
        "activityDescription": "Foreningen har till andamal att framja medlemmarnas ekonomiska intressen genom att samarbeta med naringsidkaren pa restaurangrorelse.",
        "activities": {
          "ISIC": [{ "code": "5610", "description": "Restaurants and mobile food service activities", "isAIInferred": true }]
        },
        "legalAddress": {
          "city": "Eskilstuna",
          "countryCode": "SE",
          "state": "Sodermanland County"
        }
      },
      "legalRepresentatives": [],
      "otherKeyPersons": [
        {
          "type": "individual",
          "role": { "localName": "Likvidator", "englishTranslation": "Liquidator", "standardized": "Other" },
          "individual": { "name": { "firstName": "Nils", "lastName": "Kropp", "fullName": "Nils Anders Kropp" } }
        }
      ],
      "shareholders": []
    }
    ```

    **Note:** Economic associations (Ekonomisk forening) use "Statutes" (Stadgar) instead of "Articles of Association" (Bolagsordning). When in liquidation, the liquidator appears as an other key person.
  </Accordion>

  <Accordion title="Available Documents Response">
    ```json theme={null}
    {
      "documents": {
        "financialStatements": [
          { "id": "doc_fs_2024", "name": "Annual report - 2024 - pdf", "description": "Annual report from the Swedish Business Register (Bolagsverket)", "format": "pdf", "price": 0 },
          { "id": "doc_fs_2023", "name": "Annual report - 2023 - pdf", "description": "Annual report from the Swedish Business Register (Bolagsverket)", "format": "pdf", "price": 0 },
          { "id": "doc_fs_2022", "name": "Annual report - 2022 - pdf", "description": "Annual report from the Swedish Business Register (Bolagsverket)", "format": "pdf", "price": 0 }
        ],
        "certifiedTradeRegisterExtract": {
          "id": "doc_regbev", "name": "Certified Trade Register Extract - PDF", "description": "Extract from the Swedish Business Register", "format": "pdf", "price": 120
        },
        "articlesOfAssociation": {
          "id": "doc_bolordn", "name": "Articles of Association - PDF", "description": "Articles of association for the company", "format": "pdf", "price": 120
        },
        "minutes": {
          "id": "doc_prot", "name": "Minutes - PDF", "description": "Minutes from the company's meetings", "format": "pdf", "price": 120
        },
        "uboExtract": {
          "id": "doc_rvhbev", "name": "Ultimate Beneficial Owners Extract - PDF", "description": "Extract from the register of beneficial owners", "format": "pdf", "price": 120
        },
        "currentAssignments": {
          "id": "doc_aktuppd", "name": "Current Assignments - PDF", "description": "Current assignments for a person or company", "format": "pdf", "price": 120
        }
      }
    }
    ```

    **Note:** Free annual reports (from the API) have `price: 0`. Purchasable documents from the website have a price in SEK. Prices shown are placeholder values.
  </Accordion>

  <Accordion title="UBO (Ultimate Beneficial Owners) Response">
    ```json theme={null}
    {
      "ultimateBeneficialOwners": [
        {
          "name": { "firstName": "Erik", "lastName": "Lindberg", "fullName": "Erik Johan Lindberg" },
          "dateOfBirth": "1975-06-15",
          "nationality": "Swedish",
          "residenceCountry": "SE",
          "controlType": "significant-influence-or-control",
          "controlDescription": "Control extent: 100%. Type of control: through shares, participations, membership, agreements.",
          "nature": "direct"
        },
        {
          "name": { "firstName": "Maria", "lastName": "Svensson", "fullName": "Maria Anna Svensson" },
          "dateOfBirth": "1980-03-22",
          "nationality": "Swedish",
          "residenceCountry": "SE",
          "controlType": "significant-influence-or-control",
          "controlDescription": "Control extent: 100%. Type of control: through other companies or associations. Control exercised through: Nordisk Holding AB.",
          "nature": "indirect"
        }
      ]
    }
    ```

    **Note:** UBO data is AI-extracted from the retrieved UBO Extract document. The Swedish field "Omfattning" (extent) represents **control extent**, not ownership percentage. Multiple UBOs can each show 100% because they each have a control path giving full influence over the company. The `percentageValue` field is not populated because the Swedish register reports control extent, not economic ownership stake.
  </Accordion>
</AccordionGroup>
