The Integrated Search Engine REST API enables you to search for a company's organization number or a consumer's personal identification number using details such as name, address, postal code, city, or any combination of these.
This is especially useful when you want to add an organization or personal ID to your records, or when registering new customers who are missing this information.
Many of Creditsafe's other APIs require the organization or personal ID in the request. If you already use, or are planning to implement additional APIs, this is an excellent starting point.
The Search Engine API is ideal for:
- Finding organization numbers when registering new company customers
- Locating personal identification numbers for consumer registration
- Verifying customer information before creating records in your system
- Enriching existing data with accurate identification numbers
- Preparing data for other Creditsafe APIs that require organization or personal IDs
The Integration team is available to assist with any technical questions that may arise during development or post-launch. You can reach them at integration@creditsafe.se
JSON Communication:
- The Integrated Search Engine is a REST API that communicates using JSON
- The API contains two different methods: one for companies (SearchCompany) and one for consumers (SearchConsumer)
- The API returns a fixed set of parameters for companies and consumers respectively
Including Inactive Results:
- You can choose to include inactive companies or consumers in the search results
- This is useful when the information you have may be outdated
- Instead of getting no results, the search will indicate whether the company is inactive or if the person is, for example, deceased or has emigrated
API Evolution:
- We reserve the right to add new information, tags, or attributes to the service at any time without prior notice
- We will not remove any existing elements without notifying you 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 Search Engine provides two distinct search methods:
Search for companies using:
- Complete or partial company name
- Organization number (without hyphen)
- Address, city, or postal code
- Telephone number
- Company type filter
Search for individuals using:
- Complete or partial person's name
- Personal identification number (without hyphen)
- Address, city, or postal code
- Review the Sandbox section to set up your development environment
- Refer to Requests and Responses for detailed API usage
- Check Error Codes for troubleshooting
- Contact the Integration team at integration@creditsafe.se for API access and credentials