---
title: "Sweden"
url: "https://developer.incode.com/general-reference/sweden/"
section: "general-reference"
group: "eKYB Reference / eKYB Verification Coverage"
version: "v1.1"
status: "live"
---
# Sweden
eKYB in Sweden leverages Creditsafe as the vendor to validate the legitimacy of businesses, including their organisation number, business name, business address, along with UBOs and directors.

## Source

| Source | Description |
| --- | --- |
| Creditsafe | Validates Swedish businesses against Creditsafe's company data, sourced from the Swedish Companies Registration Office (Bolagsverket). |

## Direct API approach

For general integration notes and shared response semantics, see the [eKYB Verification API Reference](/general-reference/ekyb-verification-api-reference/).

All module configurations and user data can be forwarded directly in the request for performing a KYB search. This overrides existing configuration and data collected about the user.

### Endpoint

`POST /omni/externalVerification/ekyb`

### Request parameters

| Parameter | Required | Description |
| --- | --- | --- |
| plugins | Mandatory | String array. Must be `["ekyb"]`. |
| country | Mandatory | String. Two-letter Alpha-2 country code. Must be `SE`.  |
| taxId | Mandatory | String. Swedish Organisationsnummer or VAT number. See [Tax ID formats](#tax-id-formats) below for details. |
| businessName | Optional | String. Registered name of the business. |
| street | Optional | String. Street name of the business address. |
| houseNo | Optional | String. Building or house number. |
| addressLine2 | Optional | String. Additional address information. |
| city | Optional | String. City of the business address. |
| state | Optional | String. State or region of the business address. |
| postalCode | Optional | String. Swedish postal code. Format: exactly 5 digits (for example, `21586`; may be given with a space as `215 86`). |
| uboNames | Optional | Array of strings. Full legal name(s) of Ultimate Beneficial Owners to check against business records. |
| directors | Optional | Array of strings. Full legal name(s) of directors to check against business records. |

### Tax ID formats



| ID Type | Description | Format | Example |
| --- | --- | --- | --- |
| **Organisationsnummer** (Swedish Organization Number) | Unique identifier for Swedish legal entities | Exactly 10 numeric digits, commonly formatted as `XXXXXX-XXXX` | `5567249775` |
| **VAT number** | Swedish VAT identifier | `SE` + 10-digit organisationsnummer + `01` | `SE556724977501` |

Inputs that do not match either format return a 400 error.

### Sample request

```json
{
    "plugins": ["ekyb"],
    "country": "SE",
    "taxId": "5567249775",
    "businessName": "Shoes & Bags Sweden AB",
    "street": "Nornegatan",
    "houseNo": "3",
    "addressLine2": "",
    "city": "MALMÖ",
    "state": "",
    "postalCode": "21586",
    "uboNames": [""],
    "directors": ["Gert Olof Peter Veraeus"]
}
```



### Sample response

```json
{
  "kyb": [
    { "key": "name",                 "sub_label": "Verified" },
    { "key": "tin",                  "sub_label": "Verified" },
    { "key": "address_verification", "sub_label": "Approximate Match" },
    { "key": "cityMatch",            "sub_label": "Verified" },
    { "key": "postalCodeMatch",      "sub_label": "Verified" },
    { "key": "registrationStatus",   "sub_label": "Active" },
    {
      "key": "entityType",
      "entityType": {
        "entityType": "Limited liability company"
      }
    },
    {
      "key": "directors_name_match",
      "sub_label": "Verified",
      "directorsName_input": "Gert Olof Peter Veraeus"
    }
  ]
}
```

:::note
**Note on `ubo_name_match`**: If Creditsafe returns no `shareHolders` block for a given company (only `issuedShareCapital`), `ubo_name_match` is omitted from the response entirely rather than returned as `Unverified` — absent shareholder data is not treated as a failed match. This appears to be more common for Swedish companies than for other countries covered so far, and is called out here as a documented behavior pending confirmation against additional Swedish company samples.
:::

### Response fields

| Incode API Key | Status | Definition |
| --- | --- | --- |
| name | Verified, Approximate Match, Unverified | Submitted business name is verified, approximate match, or unverified against Creditsafe's `registeredCompanyName`. Incode performs fuzzy matching. |
| tin | Verified, Unverified | Submitted organisationsnummer (tax ID) is found or not found via Creditsafe's `regNo`. |
| address\_verification | Verified, Approximate Match, Unverified | Submitted address (`houseNo` + `street` + `addressLine2` + `city` + `state` + `postalCode`) is verified, approximate match, or unverified against Creditsafe's `simpleValue` address string. Fuzzy matching is applied to the full address. |
| cityMatch | Verified, Approximate Match, Unverified | Submitted city is verified, approximate match, or unverified against Creditsafe's `city` field. |
| postalCodeMatch | Verified, Unverified | Submitted postal code is verified or unverified against Creditsafe's `postalCode` field. Format: exactly 5 digits (for example, `21586`). |
| registrationStatus | Active, Not active | Current registration status of the business. Sourced from Creditsafe's `status` field (step 1) or `companySummary.companyStatus` (step 2). Possible Creditsafe values include `Active` and `NonActive`, mapped to `Active` / `Not active` respectively. |
| entityType | Legal entity type of the business | The legal form of the business as returned from Creditsafe (for example, `Limited liability company`). Passed through as-is — not fuzzy matched against anything in the request. |
| ubo\_name\_match | Verified, Approximate Match, Unverified (or omitted) | Submitted UBO name is matched against Creditsafe's `shareHolders` block. One entry is returned per submitted UBO name, distinguishable via `uboName_input`. **Omitted entirely** if Creditsafe returns no `shareHolders` data for the company (see note above). |
| directors\_name\_match | Verified, Approximate Match, Unverified | Submitted director name is matched against Creditsafe's `directors` block. One entry is returned per submitted director name, distinguishable via `directorsName_input`. |

Learning more about *Approximate Match*: Approximate Match is generated through Incode's proprietary fuzzy matching algorithm. If approximate match is returned, the algorithm has identified a similar match with the string submitted in relation to the string stored in Creditsafe's data for a particular field. Approximate Match is returned when exact matches are not possible due to misspellings, typographical errors, or slight variations in input data.

## Error responses

See the [eKYB Verification API Reference](/general-reference/ekyb-verification-api-reference/) for standard error responses.

## Single Session Dashboard results

Results for Sweden eKYB are available on the Business tab in [single Session view](/dashboard-platform-administration/single-session-view/).