{"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":"Requests and Responses","llmstxt":{"hide":true}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"requests-and-responses","__idx":0},"children":["Requests and Responses"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication","__idx":1},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To be able to retrieve company or consumer data, you must first authenticate your user account."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Please refer to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/country-apis-catalog/product-catalog/se/authenticate"},"children":["Authenticate API documentation"]}," for details on how to authenticate and obtain a token."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The generated token can be used across all Creditsafe Sweden REST APIs including DateCheck, GetData, SearchEngine, GetSignatory, GetUnitData, and SPAR."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"production-urls","__idx":2},"children":["Production URLs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GetData Endpoint:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"https://se-webservice.apps.creditsafe.com/getdata\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Health Check:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"https://se-webservice.apps.creditsafe.com/getdata/health\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"request-methods","__idx":3},"children":["Request Methods"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The GetData REST API uses a single ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET"]}," method for both consumers and companies."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"getdata-request","__idx":4},"children":["GetData Request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /getdata\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example Request:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"HEADER: Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6Im…hPeGE7Ak8YtKFbA \nURL: https://se-webservice.apps.creditsafe.com/getdata?searchnumber=5565144408&blockname=FinancialSummary&language=sv\nMethod: GET\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"request-parameters","__idx":5},"children":["Request Parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The table below describes each parameter included in the requests."]},{"$$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":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Data type"},"children":["Data type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Max length"},"children":["Max length"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["searchnumber"]}," (query)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["12"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Personal number or organization number (up to 12 digits). The consumer and company requests are identical, the only difference is the block used and the search number"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["blockname"]}," (query)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Name of the GetData block that specifies which parameters to return. Blocks are setup for you by Creditsafe's integration team based upon your request"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["transactionid"]}," (query)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["14"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer's internal information (customer/invoice number). Recommended to use this field as it can be helpful in tracking your call in Creditsafe logs"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["language"]}," (query)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sets the language of the response. This will also impact error response language. Available languages: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sv"]}," (Swedish) or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["en"]}," (English). Default: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["en"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["lodfreetext"]}," (query)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional. Any text to be included on the letter of disclosure. The text string sent in this parameter will be added as free text on the letter of disclosure. If no letter is sent, the text will be ignored. If multiple requests are made on the same search object (organization or person) on the same day, all unique texts will be added to the letter (up to 500 characters). All letters of disclosure are sent in Swedish. You can have both static LOD free texts on your user and use these transactional free texts with this service. If you use free texts in both your GetData request and those defined on your user, both texts will be added to the letter"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["legacyformat"]}," (query)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If you leave this parameter out or send a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," value you will get the new format used in Creditsafe REST APIs. Pass ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," into this parameter if you want the API to respond with the old SOAP parameter format from previous versions of this service. The main reason to request the legacy format is if you are moving from the SOAP implementation to this new REST version and want a minimum of work with changing your implementation. With legacy format you can also cherry-pick exactly the parameters you want in the response, whereas the new structured format will respond with full parameter lists of sections requested"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Sandbox Parameter Behavior"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the sandbox version of this API, only the parameters ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["searchnumber"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionid"]}," are actively supported. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Blockname"]}," will respond with an error if empty but otherwise its content is ignored."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All other parameters included in the request will be ignored without error or warning."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Developers are encouraged to structure their requests as they would in a production environment, including all expected parameters. This ensures consistency and simplifies the transition to production usage. However, it is important to understand that in sandbox mode, unsupported parameters will not influence the response and should not be relied upon for testing behavior or data validation."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-successful","__idx":6},"children":["Response (Successful)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All successful responses include a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metaData"]}," object containing request information for tracing and troubleshooting, and a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report"]}," object containing all sections registered in the GetData block."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Legacy Format Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This document only illustrates the response when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["legacyformat = false"]}," (default). For more information on the legacy format, please contact Creditsafe's Integration team for assistance."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"http-response-code-200-ok","__idx":7},"children":["HTTP Response code: 200 OK"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"metaData\": {\n    \"apiLogId\": 2098765,\n    \"timeStamp\": \"2026-06-12T14:30:00\",\n    \"resource\": \"GetData (1217)\",\n    \"method\": \"GET\",\n    \"requestUrl\": \"https://se-webservice.apps.creditsafe.com/getdata?blockname=COMPANY_BLOCK&language=en&searchnumber=5565144408&transactionid=TX789\",\n    \"lodCreated\": true\n  },\n  \"report\": {\n    \"basicInformation\": {\n      \"organizationNumber\": \"5565144408\",\n      \"safeNumber\": \"SE00916021\",\n      \"cfarNumber\": 33117508,\n      \"companyName\": \"Creditsafe i Sverige AB\",\n      \"previousCompanyName\": \"The old Company name\",\n      \"formedDate\": \"1995-05-30T00:00:00\",\n      \"incorporationDate\": \"1995-09-19T00:00:00\",\n      \"companyStatus\": {\n        \"date\": \"2023-02-06T00:00:00\",\n        \"status\": \"Aktivt\"\n      },\n      \"companyType\": {\n        \"code\": \"AB\",\n        \"description\": \"Privat aktiebolag\",\n        \"legalCode\": 49\n      },\n      \"industry\": {\n        \"mainIndustry\": {\n          \"code\": \"82910\",\n          \"description\": \"Inkasso- och kreditupplysningsföretag\"\n        },\n        \"secondaryActivities\": [\n          {\n            \"code\": \"78200\",\n            \"description\": \"Personaluthyrningsföretag\"\n          }\n        ]\n      },\n      \"taxInformation\": {\n        \"fTax\": {\n          \"registered\": true,\n          \"startDate\": \"1995-01-01T00:00:00\"\n        },\n        \"vat\": {\n          \"registered\": true,\n          \"startDate\": \"1995-01-01T00:00:00\",\n          \"vatNumber\": \"SE556514440801\"\n        },\n        \"employmentTax\": {\n          \"registered\": true\n        }\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-parameters","__idx":8},"children":["Response Parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response contains two main sections:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"metadata","__idx":9},"children":["metaData"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metaData"]}," object contains request information for tracing and troubleshooting:"]},{"$$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":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Data type"},"children":["Data type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["apiLogId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unique identifier for the Creditsafe API log. Refer to this ID when contacting support"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["timeStamp"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DateTime"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The exact time when the request was processed by Creditsafe. Format: YYYY-MM-DDTHH:MM:SS"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["resource"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates which service delivered the report"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["method"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the HTTP method used for the request"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["requestUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The complete URL of the request sent to Creditsafe"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["lodCreated"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates whether a Letter of Disclosure (LOD) was created for this request"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"report","__idx":10},"children":["report"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report"]}," object structure depends on the Block configuration. Each section in your Block will contain specific parameters."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For detailed information about all available sections and parameters:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contact Creditsafe's integration team for your specific Block template documentation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See your Block configuration details for which sections are included in your responses"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Null Values"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Please note that parameters with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," value are hidden in the responses of Creditsafe's REST APIs."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"understanding-the-response","__idx":11},"children":["Understanding the Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The GetData API returns structured data based on your configured Block. The response includes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Comprehensive data coverage"]}," - Approximately 500 parameters available for companies and 175 for consumers"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Block-specific sections"]}," - Only the sections defined in your Block configuration are included"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Flexible structure"]}," - Data is organized into logical sections (basic information, financial data, credit information, etc.)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Language support"]}," - Response descriptions are available in Swedish or English based on the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language"]}," parameter"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The exact structure and available parameters vary depending on your Block configuration and whether you're querying company or consumer data."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"partial-success-responses","__idx":12},"children":["Partial Success Responses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The GetData API may return HTTP ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["200 OK"]}," responses that contain both an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]}," object and a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report"]}," object. These are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"when-partial-success-occurs","__idx":13},"children":["When Partial Success Occurs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Partial success responses occur in the following scenarios:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Consumer/Sole Trader Statuses:"]}," Rejection codes S2 (protected), S6 (emigrated), or similar statuses where your block is configured to allow partial data"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Company Statuses:"]}," Rejection codes S200–S391 (inactive, deregistered, liquidated, etc.) where your block is configured to allow partial data"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Service Failures:"]}," Error code RE99 (real estate data unavailable) where other block sections are successfully retrieved"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"partial-success-response-structure","__idx":14},"children":["Partial Success Response Structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A partial success response contains:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"metaData\": {\n    \"apiLogId\": 2098766,\n    \"timeStamp\": \"2026-06-12T14:31:00\",\n    \"resource\": \"GetData (1217)\",\n    \"method\": \"GET\",\n    \"requestUrl\": \"https://se-webservice.apps.creditsafe.com/getdata?blockname=CONSUMER_BLOCK&searchnumber=198001011234\",\n    \"lodCreated\": false\n  },\n  \"error\": {\n    \"code\": \"S2\",\n    \"text\": \"Skyddad\",\n    \"detail\": \"Skyddad person.\"\n  },\n  \"report\": {\n    // Available data sections based on block configuration\n    // For S2: all data except name and address\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"handling-partial-success-responses","__idx":15},"children":["Handling Partial Success Responses"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important for Clients"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Clients ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["must not"]}," treat the presence of an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]}," object as a hard failure when the HTTP status is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["200 OK"]},". Always:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check the HTTP status code first"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If HTTP 200, inspect whether both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report"]}," are present"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error.code"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error.text"]}," to understand the status"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Process the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report"]}," data if it exists"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report"]}," is absent from the response, it means no data is available (the field is omitted from the JSON, not returned as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},")"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"block-settings-impact","__idx":16},"children":["Block Settings Impact"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your GetData block configuration determines whether partial data is returned for specific statuses:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Status allowed on block:"]}," Response includes both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]}," (status information) and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report"]}," (available data)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Status not allowed on block:"]}," Response includes only ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metaData"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]}," (no ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report"]},")"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contact Creditsafe's integration team to configure which statuses should return partial data for your blocks."]}]},"headings":[{"value":"Requests and Responses","id":"requests-and-responses","depth":1},{"value":"Authentication","id":"authentication","depth":2},{"value":"Production URLs","id":"production-urls","depth":2},{"value":"Request Methods","id":"request-methods","depth":2},{"value":"GetData Request","id":"getdata-request","depth":3},{"value":"Request Parameters","id":"request-parameters","depth":2},{"value":"Response (Successful)","id":"response-successful","depth":2},{"value":"HTTP Response code: 200 OK","id":"http-response-code-200-ok","depth":3},{"value":"Response Parameters","id":"response-parameters","depth":2},{"value":"metaData","id":"metadata","depth":3},{"value":"report","id":"report","depth":3},{"value":"Understanding the Response","id":"understanding-the-response","depth":2},{"value":"Partial Success Responses","id":"partial-success-responses","depth":2},{"value":"When Partial Success Occurs","id":"when-partial-success-occurs","depth":3},{"value":"Partial Success Response Structure","id":"partial-success-response-structure","depth":3},{"value":"Handling Partial Success Responses","id":"handling-partial-success-responses","depth":3},{"value":"Block Settings Impact","id":"block-settings-impact","depth":3}],"frontmatter":{"seo":{"title":"Requests and Responses"}},"lastModified":"2026-08-03T10:46:01.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/country-apis-catalog/product-catalog/se/getdata/documentation/requests-responses","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}