{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-country-apis-catalog/product-catalog/se/authenticate/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Error Codes"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"__idx":0,"id":"error-codes"},"children":["Error Codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page documents the various error responses you may encounter when calling the CONNECT Authenticate API."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":1,"id":"failed-service-requests"},"children":["Failed Service Requests"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Not providing a username or password will receive a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["401 Unauthorized"]}," HTTP Status."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Rate Limiting"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Rate limiting is implemented on the Authenticate endpoint to ensure fair usage and to protect the service from excessive requests."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Up to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["5 identical invalid requests"]}," are permitted within a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["2-minute period"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Upon reaching this limit, any further identical requests will receive a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["429 HTTP Status (Too Many Requests)"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["There is also a threshold for the total number of authentication requests allowed within a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["5-minute window"]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"danger","name":"Important: Avoid Automated Retries"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["strongly recommend"]}," that integrations avoid repeating automated identical invalid authorization requests. Instead, catch an unauthorized response and terminate the processing."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Violating this recommendation and reaching the threshold will result in a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["lockout of the endpoint"]},". If this occurs, you will need to wait ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["5 minutes"]}," before the endpoint will accept new requests."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To protect our customer base from the effects of misuse of the Authorization endpoint, Creditsafe may ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["block a customer account or IP address"]}," if too many calls using invalid credentials are identified."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":2,"id":"error-response-codes"},"children":["Error Response Codes"]},{"$$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":"HTTP Status Code"},"children":["HTTP Status Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Response Body"},"children":["Response Body"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["400"]}," Bad Request"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(Empty or minimal error message)"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["401"]}," Unauthorized"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Access denied - Please check that your username and password are correct. Please be aware that usernames and passwords are case sensitive. If the problem persists, please contact your Creditsafe account manager."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["429"]}," Too Many Requests"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Too many identical requests within a 2-minute period or total amount of requests exceeded"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":3,"id":"common-problems-and-solutions"},"children":["Common Problems and Solutions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The most common problems to look for when authorization fails are:"]},{"$$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":"Problem"},"children":["Problem"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Solution"},"children":["Solution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unauthorized"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Credentials are case sensitive. Has the password changed?"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Email based username is provided instead of the user key"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Make sure to always use ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User Key"]}," as username when authorizing to API's. Email addresses will not work."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customer or user is not active in the Creditsafe system"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check with Creditsafe integration support"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The user has been locked out due to too many bad authorization attempts in a row"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wait 2 minutes until the user is unlocked again"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The user was recently linked to an Identity with one or more other users, leaving the users with different passwords"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check with Creditsafe integration support. If this problem is assumed, ask for a reset of the Identity password. Please note that this would change passwords for all users linked to that Identity"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":4,"id":"token-expired-error-403"},"children":["Token Expired Error (403)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["expired token"]}," is used in a service call (not the authenticate endpoint itself), a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["403 HTTP Status (Token Expired)"]}," response will be returned."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This indicates that your token has exceeded its 1-hour lifetime and needs to be refreshed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Recommended Solutions:"]}]},{"$$mdtype":"Tag","name":"ol","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":["Track token generation time and proactively refresh approximately 55 minutes after generation"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Contact Support"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you continue to experience authentication issues, contact the Creditsafe Integration team at ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:integration@creditsafe.se"},"children":["integration@creditsafe.se"]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Indicates that rate limits have been exceeded."]},{"$$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":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Text"},"children":["Text"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Detail"},"children":["Detail"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Solution"},"children":["Solution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["429"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Too many requests"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rate limit exceeded"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wait before retrying, implement exponential backoff"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"error\": {\n    \"code\": \"429\",\n    \"text\": \"Too many requests\",\n    \"detail\": \"Rate limit exceeded. Please wait before retrying.\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"__idx":5,"id":"500-internal-server-error"},"children":["500 Internal Server Error"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Indicates an unexpected error occurred on the server."]},{"$$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":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Text"},"children":["Text"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Detail"},"children":["Detail"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Solution"},"children":["Solution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Internal server error"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An unexpected error occurred"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Try again later. If the issue persists, contact ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:integration@creditsafe.se"},"children":["integration@creditsafe.se"]}," with the timestamp and error details"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"error\": {\n    \"code\": \"500\",\n    \"text\": \"Internal server error\",\n    \"detail\": \"An unexpected error occurred. Please try again later.\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":6,"id":"troubleshooting-tips"},"children":["Troubleshooting Tips"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Invalid Credentials (401)"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify username and password are exactly as provided by Creditsafe"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check for extra spaces or hidden characters"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Remember that credentials are case-sensitive"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account Issues (401/403)"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm your account has been activated"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check if you've completed the welcome email setup process"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contact ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:integration@creditsafe.se"},"children":["integration@creditsafe.se"]}," if account issues persist"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rate Limiting (429)"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Implement token caching to reduce authentication requests"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add exponential backoff retry logic"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reuse tokens across multiple API calls"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Service Issues (500)"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check Creditsafe service status"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retry after a brief delay"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contact support if issues persist beyond 15 minutes"]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Need Help?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For any authentication issues that cannot be resolved using this documentation, please contact the Integration team at ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:integration@creditsafe.se"},"children":["integration@creditsafe.se"]}]}," with:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The timestamp of the failed request"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The full error response received"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your username (never send your password)"]}]}]}]},"headings":[{"value":"Error Codes","id":"error-codes","depth":1},{"value":"Failed Service Requests","id":"failed-service-requests","depth":2},{"value":"Error Response Codes","id":"error-response-codes","depth":2},{"value":"Common Problems and Solutions","id":"common-problems-and-solutions","depth":2},{"value":"Token Expired Error (403)","id":"token-expired-error-403","depth":2},{"value":"500 Internal Server Error","id":"500-internal-server-error","depth":3},{"value":"Troubleshooting Tips","id":"troubleshooting-tips","depth":2}],"frontmatter":{"seo":{"title":"Error Codes"}},"lastModified":"2026-04-28T11:14:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/country-apis-catalog/product-catalog/se/authenticate/documentation/errorcodes","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}