Requests and Responses

To be able to retrieve company or consumer data, you must first authenticate your user account.

Please refer to the Authenticate API documentation for details on how to authenticate and obtain a token.

The generated token can be used across all Creditsafe Sweden REST APIs including DateCheck, GetData, SearchEngine, GetSignatory, GetUnitData, and SPAR.

GetData Endpoint:

https://se-webservice.apps.creditsafe.com/getdata

Health Check:

https://se-webservice.apps.creditsafe.com/getdata/health

The GetData REST API uses a single GET method for both consumers and companies.

Endpoint:

GET /getdata

Example Request:

HEADER: Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6Im…hPeGE7Ak8YtKFbA 
URL: https://se-webservice.apps.creditsafe.com/getdata?searchnumber=5565144408&blockname=FinancialSummary&language=sv
Method: GET

The table below describes each parameter included in the requests.

All successful responses include a metaData object containing request information for tracing and troubleshooting, and a report object containing all sections registered in the GetData block.

The below response shows how a GetData response is structured. This example uses fake data and only includes the BasicInformation section of a company report.

Both consumer and company reports have many more sections of data available. You can find details on the parameters included in each section in the separate Block template documentation.

{
  "metaData": {
    "apiLogId": 2098765,
    "timeStamp": "2026-06-12T14:30:00",
    "resource": "GetData (1217)",
    "method": "GET",
    "requestUrl": "https://se-webservice.apps.creditsafe.com/getdata?blockname=COMPANY_BLOCK&language=en&searchnumber=5565144408&transactionid=TX789",
    "lodCreated": true
  },
  "report": {
    "basicInformation": {
      "organizationNumber": "5565144408",
      "safeNumber": "SE00916021",
      "cfarNumber": 33117508,
      "companyName": "Creditsafe i Sverige AB",
      "previousCompanyName": "The old Company name",
      "formedDate": "1995-05-30T00:00:00",
      "incorporationDate": "1995-09-19T00:00:00",
      "companyStatus": {
        "date": "2023-02-06T00:00:00",
        "status": "Aktivt"
      },
      "companyType": {
        "code": "AB",
        "description": "Privat aktiebolag",
        "legalCode": 49
      },
      "industry": {
        "mainIndustry": {
          "code": "82910",
          "description": "Inkasso- och kreditupplysningsföretag"
        },
        "secondaryActivities": [
          {
            "code": "78200",
            "description": "Personaluthyrningsföretag"
          }
        ]
      },
      "taxInformation": {
        "fTax": {
          "registered": true,
          "startDate": "1995-01-01T00:00:00"
        },
        "vat": {
          "registered": true,
          "startDate": "1995-01-01T00:00:00",
          "vatNumber": "SE556514440801"
        },
        "employmentTax": {
          "registered": true
        }
      }
    }
  }
}

The response contains two main sections:

The metaData object contains request information for tracing and troubleshooting:

The report object structure depends on the Block configuration. Each section in your Block will contain specific parameters.

For detailed information about all available sections and parameters:

• Contact Creditsafe's integration team for your specific Block template documentation
• See your Block configuration details for which sections are included in your responses

The GetData API returns structured data based on your configured Block. The response includes:

• Comprehensive data coverage - Approximately 500 parameters available for companies and 175 for consumers
• Block-specific sections - Only the sections defined in your Block configuration are included
• Flexible structure - Data is organized into logical sections (basic information, financial data, credit information, etc.)
• Language support - Response descriptions are available in Swedish or English based on the language parameter

The exact structure and available parameters vary depending on your Block configuration and whether you're querying company or consumer data.

The GetData API may return HTTP 200 OK responses that contain both an error object and a report object. These are partial success responses where the person or company has a register status (such as protected, emigrated, or inactive), but data is still available based on your block settings.

Partial success responses occur in the following scenarios:

1. Consumer/Sole Trader Statuses: Rejection codes S2 (protected), S6 (emigrated), or similar statuses where your block is configured to allow partial data
2. Company Statuses: Rejection codes S200–S391 (inactive, deregistered, liquidated, etc.) where your block is configured to allow partial data
3. Service Failures: Error code RE99 (real estate data unavailable) where other block sections are successfully retrieved

A partial success response contains:

{
  "metaData": {
    "apiLogId": 2098766,
    "timeStamp": "2026-06-12T14:31:00",
    "resource": "GetData (1217)",
    "method": "GET",
    "requestUrl": "https://se-webservice.apps.creditsafe.com/getdata?blockname=CONSUMER_BLOCK&searchnumber=198001011234",
    "lodCreated": false
  },
  "error": {
    "code": "S2",
    "text": "Skyddad",
    "detail": "Skyddad person."
  },
  "report": {
    // Available data sections based on block configuration
    // For S2: all data except name and address
  }
}

Your GetData block configuration determines whether partial data is returned for specific statuses:

• Status allowed on block: Response includes both error (status information) and report (available data)
• Status not allowed on block: Response includes only metaData and error (no report)

Contact Creditsafe's integration team to configure which statuses should return partial data for your blocks.