Skip to content
Country APIs Catalog/Get Data Unit/
/Data Retrieval

Data Retrieval

Operations for retrieving company unit data

Operations

Retrieve company unit data

Request

Retrieves company unit data based on search parameters. Returns 404 if not found or 400 for invalid input.

Security
bearerToken
Query
searchnumberstring, <= 10 characters

Unique identifier used to search for a company or business entity. Organization number (typically 10 digits). The value is normalised by the service before processing.

namestring

Company or business name used as search criteria.

addressstring

Address value used as search criteria.

postnrstring

Postal code used as search criteria.

includeinactiveboolean

When set to true, inactive entities are included in the results.

Default:false
legacyformatboolean

Controls whether the response is returned in a legacy format. If you leave this parameter out or send a false value you will get the new format used in Creditsafe REST APIs. Pass true into this parameter if you want the API to respond with the old SOAP parameter format from previous versions of this service.

Default:false
languagestring

Language used for response content and messages. Supported values are English (en) and Swedish (sv).

Default:"en"
Enum:"en""sv"
transactionidstring, <= 14 characters

Customer's internal information (customer/invoice number). Recommended to use this field as it can be helpful in tracking your call in Creditsafe logs.

curl -i -X GET \
  'https://se-webservice.apps.creditsafe.com/getdataunit?searchnumber=string&name=string&address=string&postnr=string&includeinactive=false&legacyformat=false&language=en&transactionid=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Successful response with list of company units

Bodyapplication/json
metaDataobjectrequired

Metadata section containing request information for tracing and troubleshooting

reportArray of objects(GetDataUnitRestResponse)required

Array of company units for the organization

Response
{
  "metaData": {
    "apiLogId": 0,
    "timeStamp": "2019-08-24T14:15:22Z",
    "resource": "string",
    "method": "string",
    "requestUrl": "string"
  },
  "report": [
    { … }
  ]
}