The GetData REST API is designed to retrieve a comprehensive set of parameters for companies and individuals. With approximately 500 parameters available for companies and 175 for consumers, this service provides extensive data coverage.
The GetData service can be integrated with other Creditsafe APIs to ensure that the raw data for a company or individual is accurately returned and stored for future checks, analysis, and audits. This makes it an essential tool for various applications.
Whether you need to:
- Conduct a pre-check to verify the correct company or individual
- Automatically populate name and address fields on your website or system
- Retrieve credit information to support informed credit decisions
The GetData service is highly suitable for these applications and more.
The Integration team is available to answer any technical questions that might come up during the development or afterwards. They can be reached at integration@creditsafe.se
JSON Communication:
- GetData is a REST API that communicates using JSON
- The responsibility to map the response lies with the customer
Handling Missing Data:
- Returned parameters, lists, or objects can be empty or missing from the response
- Ensure your integration can handle missing or null values
API Evolution:
- We reserve the right to add new information, tags, or attributes to the service at any time without prior communication
- We will not remove anything without communicating this in advance
- We do not guarantee that the JSON response is delivered in the same order for all requests
Implementations using this service should primarily process requests sequentially, particularly when handling batch operations with large request volumes. Sequential processing helps ensure predictable behaviour and optimal use of the service.
A limited degree of parallelism is supported; however, client implementations must be designed to tolerate temporary request throttling if traffic exceeds allowed thresholds. Clients are expected to pause request execution and resume once additional requests can be accepted.
Creditsafe reserves the right to restrict access for implementations that generate excessive load or do not properly handle enforced request limitations. Please read more about rate limiting in the section about error codes.
The GetData service response is defined by a customer-specific Block. A Block is essentially a collection of sections or parameters included in a response. Each section comprises several different parameters, some of which may be lists of data, such as a list of directors or properties.
When you make a call to the GetData service:
- Include a personal or organization number along with the Block name
- Receive the sections and parameters with the associated values for the requested object
- Control exactly which data you want to receive
The sections included in a Block are categorized as either Basic or Credit information.
Calls to Credit Blocks result in a letter of disclosure being sent for:
- Individuals (all types)
- Sole traders ("enskilda firmor")
- Trading companies ("handelsbolag")
- Partnerships ("kommanditbolag")
No disclosure letter is sent for:
- Limited companies ("aktiebolag")
- Other company types ("övriga bolagstyper")
We recommend setting up both a basic and a credit Block for both companies and individuals to allow for full flexibility:
- ✅ Basic Block for individuals
- ✅ Credit Block for individuals
- ✅ Basic Block for companies
- ✅ Credit Block for companies
| Block Type | Content | Disclosure Letter |
|---|---|---|
| Basic Block | Fundamental information: • Individuals: Name, address, status, marital status, company engagements, trustee information • Companies: Name, address, status, type of company, registration date, F-tax, VAT, employer's contribution Useful for automatically populating names and addresses | Never sent (for both individuals and companies) |
| Credit Block | All Basic Block parameters plus: • Income/financial statement information • Property information • Payment remarks • Debt balance • Bankruptcy information | Sent according to policy (see above) |
You need to request the Blocks you want to be set up for you from Creditsafe. This is done via a signed template documentation which can be produced together with your account manager and/or Creditsafe Integration team.
To optimize the performance of the response, you should avoid retrieving large sets of data you have no intention to use. Only request the sections and parameters you need.
For a full description of all available sections and their parameters, see separate documentation for consumer/company & credit/basic sections.
If you already have an implementation of an older version of GetData (SOAP), you can make your call to GetData REST API using the parameter legacyformat set to true.
- Provides a JSON response with the same parameter naming as the previous XML response from SOAP versions
- Allows you to build a limited Block with only the parameters you need
- Response is an unstructured flat list of parameters rather than the well-structured response of the new format
- Legacy format is more limited than the new format
- Some parameters may not be included in legacy format
- Any parameters available in GetData SOAP version should be available
In this example, the block contains exactly the 5 parameters shown in the response:
{
"GETDATA_RESPONSE": {
"ORGNR": "5565144408",
"NAME": "Creditsafe i Sverige AB",
"ADDRESS": "Fabriksgatan 7,Gårda Fabriker",
"ZIPCODE": "41250",
"TOWN": "GÖTEBORG"
}
}The same report using the very same block in the new format. Note: This example shows only a limited set of all parameters available in the company basicInformation section. The actual response using GetData service would provide even more parameters.
{
"basicInformation": {
"organizationNumber": "5565144408",
"safeNumber": "SE00916021",
"cfarNumber": 33117508,
"companyName": "Creditsafe i Sverige AB",
"latestNameRegistration": "laropa",
"previousCompanyName": "The old Company name",
"ownsRealEstate": false,
"formedDate": "1995-05-30T00:00:00",
"incorporationDate": "1995-09-19T00:00:00",
"contactInformation": {
"registeredAddress": {
"date": "2011-09-29T00:00:00",
"fullAddress": "Fabriksgatan 7,Gårda Fabriker",
"fullAddressWithoutCareOf": "Fabriksgatan 7,Gårda Fabriker",
"careOf": null,
"zipCode": "41250",
"town": "GÖTEBORG",
"municipality": "GÖTEBORG",
"county": "VÄSTRA GÖTALAND"
}
}
}
}- Review Sandbox for test environment setup
- Review Step-by-Step Integration Guide for the recommended call routine
- Contact the Integration team at integration@creditsafe.se for Block setup
- Refer to separate documentation for complete parameter listings