{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-country-apis-catalog/product-catalog/se/getData/sidebars.yaml","current-catalog-info":"current-catalog-info-/country-apis-catalog/product-catalog/se/getdata/openapi"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Introduction","llmstxt":{"hide":true}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"introduction","__idx":0},"children":["Introduction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The GetData REST API is designed to retrieve a comprehensive set of parameters for companies and individuals. With approximately ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["500 parameters available for companies"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["175 for consumers"]},", this service provides extensive data coverage."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-cases","__idx":1},"children":["Use Cases"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Whether you need to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Conduct a pre-check to verify the correct company or individual"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Automatically populate name and address fields on your website or system"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve credit information to support informed credit decisions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The GetData service is highly suitable for these applications and more."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"important-information","__idx":2},"children":["Important information"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Technical Support"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Integration team is available to answer any technical questions that might come up during the development or afterwards. They can be reached at ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:integration@creditsafe.se"},"children":["integration@creditsafe.se"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-considerations","__idx":3},"children":["Key Considerations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["JSON Communication:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["GetData is a REST API that communicates using JSON"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The responsibility to map the response lies with the customer"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Handling Missing Data:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Returned parameters, lists, or objects can be empty or missing from the response"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensure your integration can handle missing or null values"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Evolution:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["We reserve the right to add new information, tags, or attributes to the service at any time without prior communication"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["We will ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not remove"]}," anything without communicating this in advance"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["We do not guarantee that the JSON response is delivered in the same order for all requests"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Sequential Requests Recommended"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"getdata-blocks","__idx":4},"children":["GetData Blocks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The GetData service response is defined by a customer-specific ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-blocks-work","__idx":5},"children":["How Blocks Work"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you make a call to the GetData service:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include a personal or organization number along with the Block name"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Receive the sections and parameters with the associated values for the requested object"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Control exactly which data you want to receive"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"block-types","__idx":6},"children":["Block Types"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The sections included in a Block are categorized as either ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Basic"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Credit"]}," information."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"disclosure-letter-policy","__idx":7},"children":["Disclosure Letter Policy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Calls to Credit Blocks result in a letter of disclosure being sent for:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Individuals"]}," (all types)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sole traders"]}," (\"enskilda firmor\")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Trading companies"]}," (\"handelsbolag\")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Partnerships"]}," (\"kommanditbolag\")"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["No disclosure letter"]}," is sent for:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Limited companies"]}," (\"aktiebolag\")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Other company types"]}," (\"övriga bolagstyper\")"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"recommended-block-setup","__idx":8},"children":["Recommended Block Setup"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend setting up both a basic and a credit Block for both companies and individuals to allow for full flexibility:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["✅ Basic Block for individuals"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["✅ Credit Block for individuals"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["✅ Basic Block for companies"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["✅ Credit Block for companies"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"basic-vs-credit-blocks","__idx":9},"children":["Basic vs Credit Blocks"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Block Type"},"children":["Block Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Content"},"children":["Content"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Disclosure Letter"},"children":["Disclosure Letter"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Basic Block"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fundamental information:",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"• ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Individuals"]},": Name, address, status, marital status, company engagements, trustee information",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"• ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Companies"]},": Name, address, status, type of company, registration date, F-tax, VAT, employer's contribution",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Useful for automatically populating names and addresses"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Never sent"]}," (for both individuals and companies)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Credit Block"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["All Basic Block parameters ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["plus"]},":",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"• Income/financial statement information",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"• Property information",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"• Payment remarks",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"• Debt balance",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"• Bankruptcy information"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sent according to policy"]}," (see above)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"requesting-blocks","__idx":10},"children":["Requesting Blocks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Performance Optimization"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a full description of all available sections and their parameters, see separate documentation for consumer/company & credit/basic sections."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"legacy-format-option","__idx":11},"children":["Legacy Format Option"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["legacyformat"]}," set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"legacy-format-benefits","__idx":12},"children":["Legacy Format Benefits"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Provides a JSON response with the same parameter naming as the previous XML response from SOAP versions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Allows you to build a limited Block with only the parameters you need"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Response is an unstructured flat list of parameters rather than the well-structured response of the new format"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"legacy-format-limitations","__idx":13},"children":["Legacy Format Limitations"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Limitations"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Legacy format is more limited than the new format"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Some parameters may not be included in legacy format"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Any parameters available in GetData SOAP version should be available"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"legacy-format-examples","__idx":14},"children":["Legacy Format Examples"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-company-basic-report-legacy-format--true","__idx":15},"children":["Example: Company Basic Report (Legacy Format = true)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example, the block contains exactly the 5 parameters shown in the response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"GETDATA_RESPONSE\": {\n    \"ORGNR\": \"5565144408\",\n    \"NAME\": \"Creditsafe i Sverige AB\",\n    \"ADDRESS\": \"Fabriksgatan 7,Gårda Fabriker\",\n    \"ZIPCODE\": \"41250\",\n    \"TOWN\": \"GÖTEBORG\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-same-report-new-format","__idx":16},"children":["Example: Same Report (New Format)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["basicInformation"]}," section. The actual response using GetData service would provide even more parameters."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"basicInformation\": {\n    \"organizationNumber\": \"5565144408\",\n    \"safeNumber\": \"SE00916021\",\n    \"cfarNumber\": 33117508,\n    \"companyName\": \"Creditsafe i Sverige AB\",\n    \"latestNameRegistration\": \"laropa\",\n    \"previousCompanyName\": \"The old Company name\",\n    \"ownsRealEstate\": false,\n    \"formedDate\": \"1995-05-30T00:00:00\",\n    \"incorporationDate\": \"1995-09-19T00:00:00\",\n    \"contactInformation\": {\n      \"registeredAddress\": {\n        \"date\": \"2011-09-29T00:00:00\",\n        \"fullAddress\": \"Fabriksgatan 7,Gårda Fabriker\",\n        \"fullAddressWithoutCareOf\": \"Fabriksgatan 7,Gårda Fabriker\",\n        \"careOf\": null,\n        \"zipCode\": \"41250\",\n        \"town\": \"GÖTEBORG\",\n        \"municipality\": \"GÖTEBORG\",\n        \"county\": \"VÄSTRA GÖTALAND\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":17},"children":["Next Steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/country-apis-catalog/product-catalog/se/getdata/documentation/sandbox"},"children":["Sandbox"]}," for test environment setup"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/country-apis-catalog/product-catalog/se/getdata/documentation/step-by-step-guide"},"children":["Step-by-Step Integration Guide"]}," for the recommended call routine"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contact the Integration team at ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["integration@creditsafe.se"]}," for Block setup"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refer to separate documentation for complete parameter listings"]}]}]},"headings":[{"value":"Introduction","id":"introduction","depth":1},{"value":"Use Cases","id":"use-cases","depth":2},{"value":"Important information","id":"important-information","depth":2},{"value":"Key Considerations","id":"key-considerations","depth":2},{"value":"GetData Blocks","id":"getdata-blocks","depth":2},{"value":"How Blocks Work","id":"how-blocks-work","depth":3},{"value":"Block Types","id":"block-types","depth":3},{"value":"Disclosure Letter Policy","id":"disclosure-letter-policy","depth":4},{"value":"Recommended Block Setup","id":"recommended-block-setup","depth":3},{"value":"Basic vs Credit Blocks","id":"basic-vs-credit-blocks","depth":3},{"value":"Requesting Blocks","id":"requesting-blocks","depth":3},{"value":"Legacy Format Option","id":"legacy-format-option","depth":2},{"value":"Legacy Format Benefits","id":"legacy-format-benefits","depth":3},{"value":"Legacy Format Limitations","id":"legacy-format-limitations","depth":3},{"value":"Legacy Format Examples","id":"legacy-format-examples","depth":3},{"value":"Example: Company Basic Report (Legacy Format = true)","id":"example-company-basic-report-legacy-format--true","depth":4},{"value":"Example: Same Report (New Format)","id":"example-same-report-new-format","depth":4},{"value":"Next Steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Introduction"}},"lastModified":"2026-04-29T11:06:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/country-apis-catalog/product-catalog/se/getdata","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}