{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-country-apis-catalog/product-catalog/se/authenticate/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Introduction"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"__idx":0,"id":"introduction"},"children":["Introduction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This documentation explains how to authenticate your integration user using CONNECT Authenticate and how the provided token is utilized in service calls to Creditsafe Sweden REST APIs."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":1,"id":"important-information"},"children":["Important Information"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Integration Support"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Integration team is available to assist with any technical questions that may arise during development or post-launch. You can reach them at ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:integration@creditsafe.se"},"children":["integration@creditsafe.se"]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"API Evolution"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We reserve the right to add new information, tags, or attributes to the service at any time without prior notice. However, we will ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not remove"]}," any existing elements without notifying you in advance. Please note that we do not guarantee the JSON response will be delivered in the same order for all requests."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":2,"id":"before-implementing-a-creditsafe-webservice"},"children":["Before Implementing a Creditsafe Webservice"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before using any of the APIs available for Sweden business data, there are a few important things to understand and confirm:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Always ensure that you have read the development manual for the service you plan to use"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["It will provide essential guidance on how to build the integration"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contact integration support if you need clarification on any requirements"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":3,"id":"se-webservices-that-require-authentication-via-connect"},"children":["SE Webservices that Require Authentication via CONNECT"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This documentation covers how to use CONNECT Authenticate specifically for making calls to local Swedish REST APIs. Below is the complete list of Creditsafe Swedish REST APIs that require a token from CONNECT Authenticate:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GetDataUnits"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DateCheck Consumer"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DateCheck Company"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GetSignatory v2"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GetData"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SPAR Consumer search v2"]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Other Services"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For authentication to other Creditsafe web services not listed above, please refer to the specific development manual for those services."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you plan to build integrations using other methods of the CONNECT service, you will need a specific Creditsafe CONNECT account. A Creditsafe sales manager or the Creditsafe integration support team can assist you with setting this up if needed."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":4,"id":"how-authentication-works"},"children":["How Authentication Works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An authentication token can be obtained by calling the Authenticate endpoint with your username and password in the request body. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["username"]}," parameter is the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User Key"]}," provided to you by Creditsafe."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important: Credentials are Case-Sensitive"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The email-based usernames used for logging into Creditsafe websites are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," the same as the username required for our APIs. If you're unsure of your User Key, please contact Creditsafe integration support for assistance."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"__idx":5,"id":"token-generation"},"children":["Token Generation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Authenticate endpoint generates a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bearer JWT"]}," (authentication token), which is necessary to access the SE web services listed earlier in this document."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A successfully generated token is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["valid for one hour"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Copy the value of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["token"]}," field from the JSON response"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include it as a REST header in all service calls: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer {token}"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When your token expires, you can request a new one independently of the current token"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Multiple valid tokens can exist simultaneously"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each token can be used with any of the supported services as long as it remains active"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":6,"id":"token-refresh-strategies"},"children":["Token Refresh Strategies"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When an expired token is used in a call, a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["403 HTTP Status (Token Expired)"]}," response will be returned. We recommend using one of the following strategies to refresh tokens:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Strategy 1: Reactive Refresh"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Catch the 403 Token Expired response and refresh the token when needed"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Once refreshed, repeat the latest call that was denied"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Strategy 2: Proactive Refresh"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Track the timing of when the token was fetched"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Request a new token before the previous one expires"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["This should be done approximately ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["55 minutes"]}," after the previous token was generated"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Generating new tokens too frequently can degrade overall performance"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":7,"id":"next-steps"},"children":["Next Steps"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/country-apis-catalog/product-catalog/se/authenticate/documentation/sandbox"},"children":["Sandbox Environment"]}," section to set up your development environment"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/country-apis-catalog/product-catalog/se/authenticate/documentation/requests-responses"},"children":["Requests and Responses"]}," for detailed API usage and examples"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refer to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/country-apis-catalog/product-catalog/se/authenticate/documentation/errorcodes"},"children":["Error Codes"]}," for troubleshooting common issues"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/country-apis-catalog/product-catalog/se/authenticate/documentation/metadata"},"children":["Token Metadata"]}," to understand the JWT token structure"]}]}]},"headings":[{"value":"Introduction","id":"introduction","depth":1},{"value":"Important Information","id":"important-information","depth":2},{"value":"Before Implementing a Creditsafe Webservice","id":"before-implementing-a-creditsafe-webservice","depth":2},{"value":"SE Webservices that Require Authentication via CONNECT","id":"se-webservices-that-require-authentication-via-connect","depth":2},{"value":"How Authentication Works","id":"how-authentication-works","depth":2},{"value":"Token Generation","id":"token-generation","depth":3},{"value":"Token Refresh Strategies","id":"token-refresh-strategies","depth":2},{"value":"Next Steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Introduction"}},"lastModified":"2026-04-28T11:14:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/country-apis-catalog/product-catalog/se/authenticate","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}