Requests and Responses

Authentication

To be able to do a search for a company or consumer, you must first authenticate your user account. Please refer to the separate documentation titled Authenticate to SE Integration Services Manual for details on how to authenticate and obtain a token.

Token Usage

The generated token can be used across all Creditsafe Sweden REST APIs (see the Authentication document for the list of applicable services).

Production URLs

Company Search:

https://se-webservice.apps.creditsafe.com/search/company

Consumer Search:

https://se-webservice.apps.creditsafe.com/search/consumer

Request Methods

The Search Engine REST API includes two distinct GET methods: one for consumers and one for companies.

Company Search Request

Endpoint:

GET /search/company

Example Request:

HEADER: Authorization: Bearer <token>
URL: https://se-webservice.apps.creditsafe.com/search/company?namesearchnumber=TheCompany&companytype=AB
Method: GET

Consumer Search Request

Endpoint:

GET /search/consumer

Example Request:

HEADER: Authorization: Bearer <token>
URL: https://se-webservice.apps.creditsafe.com/search/consumer?namesearchnumber=Carl Persson&address=Storgatan
Method: GET

Request Parameters

The table below describes each parameter included in the search request:

Parameter	Data type	Max length	Required	Description
namesearchnumber (query)	String	255	Yes*	Company: Complete or part of the company's name or the complete organization number (without hyphen) Consumer: Complete or part of person's name or complete personal identity number (without hyphen) Name search is not case sensitive.
address (query)	String	255	Yes*	Street address (with or without address number)
cityorpostcode (query)	String	60	Yes*	City and/or the post code (5 digits without space, e.g. "12345")
telephone (query)	String	20	Yes*	Telephone number with or without hyphen Note: This search value will actually also give a response if the number matches a fax. Maximum 20 characters (will be truncated if longer). Only available for company search
companytype (query)	String	-	No	AB, EF, HBKB (combined HB and KB), or Other Only available for company search
includeinactive (query)	Boolean	-	No	true/false. Default is false (inactive companies/consumers are excluded by default). Available for both company and consumer search
startposition (query)	Number	-	No	Start position of the search result, must be between 1-100. Used if more than 50 search results in response. Default value is 1.
pagesize (query)	Number	-	No	Number of search results returned in the response. Must be between 1-50. Default is 25.
transactionid (query)	String	14	No	Customer's internal information (customer/invoice number). Recommended to use this field as it can be helpful in tracking your call in Creditsafe logs.
language (query)	String	3	No	Sets the language of the response Available languages: sv or en. Default: en

*At least one of these parameters is required to perform a search

Sandbox Parameter Behavior

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.

Response (Successful)

The response format from the Search Engine REST API is similar, but not identical, for consumers and companies. The change codes that may appear differ between the two.

Null Values

Please note that parameters with a null value are hidden in the responses of Creditsafe's REST APIs.

Company Response Example

HTTP Response code: 200 OK

{
  "metaData": {
    "apiLogId": 6028905,
    "timeStamp": "2026-07-13T13:50:48",
    "resource": "Company Search (1225)",
    "method": "GET",
    "requestUrl": "https://se-webservice.apps.creditsafe.com/search/company?namesearchnumber=5565144408"
  },
  "report": {
    "results": [
      {
        "organizationNumber": 5564441054,
        "companyName": "Test Aktiebolag",
        "previousCompanyName": "Aktiebolaget Föredetta",
        "address": {
          "careOf": "c/o Karlsson",
          "street": "Storgatan 12",
          "zipCode": 123456,
          "town": "GÖTEBORG",
          "addressType": 1,
          "addressTypeText": "Registered address"
        },
        "oldAddress": "Storgatan 13",
        "phone": "031-123456",
        "statusType": "Positive",
        "statusText": "Aktiv",
        "isPartOfGroup": false,
        "lastAccountPeriod": "2401-2412",
        "companyType": "AB",
        "companyTypeText": "Privat aktiebolag",
        "companyLegalGroup": "AB"
      }
    ],
    "totalCount": 1
  }
}

Consumer Response Example

HTTP Response code: 200 OK

{
  "metaData": {
    "apiLogId": 6028914,
    "timeStamp": "2026-07-13T13:51:45",
    "resource": "Consumer Search (1226)",
    "method": "GET",
    "requestUrl": "https://se-webservice.apps.creditsafe.com/search/consumer?namesearchnumber=198209170250"
  },
  "report": {
    "results": [
      {
        "personalIdentificationNumber": 196612121212,
        "name": "Karin Testperson",
        "givenName": "Karin",
        "statusTypeText": "Aktiv",
        "statusType": "Active",
        "isActive": true,
        "address": {
          "street": "Lilla gränden 1",
          "zipCode": 12345,
          "town": "BJUV",
          "addressType": 1,
          "addressTypeText": "Registered address"
        },
        "oldAddress": null,
        "specialAddress": null,
        "oldSpecialAddress": null
      }
    ],
    "totalCount": 1
  }
}

Address Fields

Please note that oldAddress, specialAddress and oldSpecialAddress would not show if they are null but here we show them for information purposes.

Response Parameters

The Search Engine returns different parameters for companies and consumers.

Company Response Parameters

Parameter	Data type	Description
organizationNumber	Number	Company organization number
companyName	String	Current registered company name
previousCompanyName	String	Previous name if company was renamed
address	Object	Registered address details containing: `careOf`, `street`, `zipCode`, `town`, `addressType`, `addressTypeText`
oldAddress	Object	Previous address if available (same structure as `address`)
phone	String	Contact phone number
statusType	String	Company status code (e.g., "Positive")
statusText	String	Company status description (e.g., "Aktiv")
isPartOfGroup	Boolean	Indicates if company is part of a group structure
lastAccountPeriod	String	Most recent accounting period (format: YYMM-YYMM)
companyType	String	Legal form code (AB, HB, KB, EF, etc.)
companyTypeText	String	Legal form description (e.g., "Privat aktiebolag")
companyLegalGroup	String	Legal group classification

Consumer Response Parameters

Parameter	Data type	Description
personalIdentificationNumber	Number	Person's identity number (12 digits)
name	String	Full name
givenName	String	First name
statusType	String	Person status code (e.g., "Active")
statusText	String	Person status description (e.g., "Aktiv")
isActive	Boolean	Indicates if person record is active
address	Object	Registered address details containing: `street`, `zipCode`, `town`, `addressType`, `addressTypeText`
oldAddress	Object	Previous address if available (same structure as `address`)
specialAddress	Object	Special postal address if registered (same structure as `address`)
oldSpecialAddress	Object	Previous special address if available (same structure as `address`)