Step-by-Step Integration Guide

This guide walks through the recommended call routine for effectively using the GetData API. The example is for consumers, but the same approach applies to companies.

Step 1: Call a Basic Block

Start every flow with a GetData call to a Basic Block to retrieve fundamental information:

Name
Address
Status
Trustee information

Basic Block calls never trigger a letter of disclosure for any entity type.

Step 2: Check the Status

Use the returned status to determine whether to continue with a credit check.

Inactive status indicators:

Deceased
Emigrated
Blocked

Avoid Unnecessary Credit Checks

If the person has an inactive status, you can automatically decline the application without requesting a credit report. No letter of disclosure will be sent.

Step 3: Call a Credit Block (Active Status Only)

If the person has an active status and no automatic decline condition applies, make a GetData call with a Credit Block to retrieve full credit information.

Disclosure Letter

Credit Block calls will trigger a letter of disclosure for individuals, sole traders ("enskilda firmor"), trading companies ("handelsbolag"), and partnerships ("kommanditbolag"). No disclosure letter is sent for limited companies ("aktiebolag") or other company types.

Step 4: Make a Credit Decision

Based on the returned parameters:

Apply your internal logic to evaluate the credit information
Make an informed credit decision
Save the decision along with the current date for audit and future reference

This saved date is also used as the reference date if you later use the DateCheck API to detect changes before requesting a new report.

Workflow Summary

Start
  └─► Basic Block Call
        └─► Check Status
              ├─► Inactive or trustee registered? → Decline (no disclosure)
              └─► Active? → Credit Block Call
                              └─► Credit Decision → Save & Document