NAV Navbar

Introduction

Our Web API provides client applications with fast and reliable access to data about companies and private persons.

Through the Roaring API your applications can retrieve and manage Roaring content. The base address of the API is https://api.roaring.io. There are several endpoints at that address, each with its own unique path. Most of the endpoints are restricted and require you to be a subscriber of that specific API for you to acquire credentials.

Get Started

Get Started: It's free!

Create an account and start testing using our sandbox for free today!

Follow these simple steps to get started for free!

Go to developer.roaring.io

  1. Click on Sign Up.
  2. Enter the required information and click Sign Up.
  3. Click API Keys.
  4. Click the button Generate Keys.
  5. Click the API you want to you use.

Use production data by choosing a payment option

To be able to run the API in the production mode you need to connect the API account to a credit card or invoice.

  1. Click Billing
  2. SelectPayment option
  3. Submit Credit Card or Invoice Company details
  4. Click activate

Special requirements to use Person API in production mode

Production mode for Person API also requires that you apply for a SPAR and or Skattetaten permit. Contact us and we will help you with the application process

The application process usually takes 2-3 weeks from start to finish.

Requests

The Roaring API is based on REST principles: data resources are accessed via standard HTTPS requests in UTF-8 format to an API endpoint. Where possible, the API strives to use appropriate HTTP verbs for each action:

Verb Description
GET Used for retrieving resources.
POST Used for creating resources.
PUT Used for changing/replacing resources or collections.
DELETE Used for deleting resources.

Responses

All data is received as a JSON object. The API Object Model visible in the presentation of each API on the developer site provides a description of all the retrievable objects.

Time and Date

Timestamps are returned in ISO 8601 format as Coordinated Universal Time (UTC) with zero offset: YYYY-MM-DDTHH:MM:SSZ and dates are in the same manner returned in format YYYY-MM-DD.

Response Status Codes

The API uses the following response status codes, as defined in the RFC 2616 and RFC 6585:

Status Code Description
200 OK - The request has succeeded. The client can read the result of the request in the body and the headers of the response.
201 Created - The request has been fulfilled and resulted in a new resource being created.
202 Accepted - The request has been accepted for processing, but the processing has not been completed.
204 No Content - The request has succeeded but returns no message body.
400 Bad Request - The request could not be understood by the server due to malformed syntax. The message body will contain more information; see Error Details
401 Unauthorized - The request requires user authentication or, if the request included authorization credentials, authorization has been refused for those credentials.
403 Forbidden - The server understood the request, but is refusing to fulfill it.
404 Not Found - The requested resource could not be found. This error can be due to a temporary or permanent condition.
500 Internal Server Error. You should never receive this error because our clever coders catch them all ... but if you are unlucky enough to get one, please report it to us.
502 Bad Gateway - The server was acting as a gateway or proxy and received an invalid response from the upstream server.
503 Service Unavailable - The server is currently unable to handle the request due to a temporary condition which will be alleviated after some delay. You can choose to resend the request again.

Error Details

Authentication Error Object

The following command returns an example of an error received when a token fails:

curl -H "Authorization: Basic Oik...vL" -d grant_type=client_credentials "https://api.roaring.io/token"

the JSON structure looks like this

  {
    "error": "invalid_client", 
    "error_description": "Invalid client secret" 
  }

The API uses two different formats to describe an error. One is for authentication errors connected to the token service and the other is the normal error received when calling the API.

Whenever the application makes requests to the API which are related to authentication or authorization, e.g. retrieving an access token, the error response follows RFC 6749 on The OAuth 2.0 Authorization Framework.

Key Value Description
error
string
A high level description of the error as specified in RFC 6749 Section 5.2
error_description
string
A more detailed description of the error as specified in RFC 6749 Section 4.1.2.1

Regular Error Object

The following command returns an example of an error received when fetching person data using a non existing person identifier:

$ `curl -i "https://api.roaring.io/person/1.0/person?personalNumber=1234"
  HTTP/1.1 400 Bad Request 
  {
    "error":"InvalidPersonalNumber", 
    "message":"The given personal number is not valid" 
  }

Apart from the response code, unsuccessful responses return information about the error as an error JSON object containing the following information:

Key Value Description
error
string
Short description of the error
message string
string
More detailed description of the error

Code Lists

General codes

Swedish codes

Swedish Company Status Codes

Below is a list of available status codes for a company. The information is displayed as a code with a descriptive text. Also, the date of the last status change is supplied.

Code Status (Svenska) Status (English)
100 Aktivt Active
101 Lagerbolag Storage company
102 Drivs i Kommission Commission
103 Konkurshistorik Bankruptcy history
104 Vilande enligt senaste årsredovisning Dormant
109 Ingen statusinformation finns Missing status information
111 Ackordsförhandling inledd Composition declared
112 Ackordsförhandling upphörd Composition cessation
113 Ackordsförhandling upphävd av domstol Composition reverse
118 Konkursansökan Applied bankruptcy
132 Likvidation beslutad Liquidation declared
133 Likvidation fortsätter Liquidation continues
134 Likvidation upphörd Liquidation cessation
135 Likvidation upphävd av domstol Liquidation reverse
140 Fusion inledd Merger declared
141 Fusion avslutad Merger concluded
142 Fusion förfallen/upphävd Merger cessation
145 Fusion tillåten Merger grant
149 Fusion pågår Merger ongoing
180 Rekonstruktion inledd Reconstruction declared
181 Rekonstruktion upphörd Reconstruction cessation
182 Rekonstruktion upphävd av domstol Reconstruction reverse
190 Konkursbeslut Bankruptcy declared
191 Konkurs nedlagd Bankruptcy withdrawn
192 Konkursbeslut med bevakning Bankruptcy declared
194 Konkurs upphävd av rätt Bankruptcy reverse
195 Konkursansökan återkallad Applied bankruptcy withdrawn
200 Inaktivt Inactive
203 Vilande Dormant
231 Likvidation avslutad Liquidation concluded
241 Fusion avslutad Merger concluded
291 Konkurs avslutad Bankruptcy concluded
292 Konkurs avslutad med överskott Bankruptcy concluded
300 Avregistrerat Delisted
336 Bolaget avfört enl 13:18 aktiebolagslagen Company stricken off according to the Companies Act 13:18
337 Bolaget avfört Company stricken off
350 Avfört enligt 17 kap 2 st handelsregisterlagen Stricken off according to the Partnership and Non-registered Partnership Act 17:2
351 Avfört enligt 11 kap 18 § lag om ek. föreningar Stricken off according to the Economic Association (co-operative) Act 11:18
352 Avregistrerat Delisted
353 Avregistrerat p g a ny innehavare Delisted due to new owner
354 Avfört p g a fusion med utländskt företag Delisted due to fusion with foreign company
360 Avfört p g a utländskt företags likvidation/konkurs Delisted due to liquidation/bankruptcy of foreign company
361 Avfört, verksamheten har upphört Delisted due to discontinuation of business operation
362 Avfört, filialen saknar verkställande direktör Delisted, the branch office has no managing director
363 Avfört, enligt domstolsbeslut Delisted, according to court order
364 Avfört, årsredovisning saknas Delisted, annual report lacking
370 Bolaget avfört på eget begäran Delisted at own request
371 Bolaget avfört av Bolagsverket Delisted by request from Bolagsverket (Companies House)
373 Avfört Stricken off
374 Avfört, omregistrerat till bankaktiebolag Stricken off, re-registered as a joint-stock bank
377 Avregistrat pga ombildning Delisted due to conversion

Norwegian codes

Norwegian Company Status Codes

Below is a list of available status codes for a company. The information is displayed as a code with a descriptive text. Also, the date of the last status change is supplied.

Code Description
S Deleted
O Dissolved
T Under forced liquidation
U Under liquidation
K Bankrupt
C Under public composition
Z No activity
A Active

API Authorization Guide

This guide shows you how to get a user’s authorization to access private data through the API.

Permission

Requests to the Roaring API require authorization; that is, the user must have granted permission for an application to access the requested data. To prove that the user has granted permission, the request header sent by the application must include a valid access token.

As the first step towards authorization, you will need to register your application on the developer page and have that application subscribe to the api that you will be calling. That will give you a unique Consumer Key and Consumer Secret to use in the authorization header.

1. Your application requests access tokens

Using your unique Consumer Key and Consumer Secret you call the token service to retrieve an access token. The call is made towards the /token endpoint:

POST https://api.roaring.io/token

The body of this POST request must contain the following parameters:

REQUEST BODY PARAMETER VALUE
grant_type Required. Shall be set to "client_credentials"

The header of this POST request must contain the following parameter:

HEADER PARAMETER VALUE
Authorization Required. Base 64 encoded string that contains the consumer key and consumer secret. The field must have the format: Authorization: Basic

2. The tokens are returned to the application

On success, the response from the Roaring Accounts service has the status code 200 OK in the response header, and the following JSON data in the response body:

KEY VALUE DESCRIPTION
access_token
string
An access token to be used in subsequent calls to the Roaring API.
token_type
string
How the access_token may be used, always "Bearer".
scope
string
A space-separated list of scopes which have been granted for this access_token
expires_in
int
The time period (in seconds) for which the access token is valid.

An example request and response to the token endpoint will look something like this:

$ curl -H "Authorization: Basic XXX...zzz" -d grant_type=client_credentials https://api.roaring.io/token 
{
  "access_token": "asdfg...xzy", 
  "token_type": "Bearer", 
  "scope": "am_application_scope default", 
  "expires_in": 3600
}

3. Use the access token to access the Roaring API

The access token allows you to make requests to the Roaring API.

An example of how access token allows you to make requests to the Roaring API.

$ curl -H "Authorization: Bearer XXXX...zzzzz" "https://api.roaring.io/person/1.0/person?personalNumber=193604139208"
{
  "posts": [
    {
      "nationalRegistryChangeDate": "2011-03-15T00:00",
      "personalNumber": "193604139208",
      "hasHistory": true,
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2011-03-15T00:00",
          "dateTo": "9999-12-31T00:00",
          "firstName": "Carina",
          "surName": "Efternamn1301",
          "gender": "F",
          "birthDate": "1936-04-13T00:00",
          "deRegistrationDate": "2011-02-02",
          "deRegistrationReason": "A"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2015-12-18T00:00",
            "dateTo": "9999-12-31T00:00",
            "registrationDate": "2002-09-01T00:00",
            "careOf": "CO-NAMN",
            "deliveryAddress2": "Gatan177 2",
            "postalNumber": "17890",
            "city": "EKERÖ",
            "districtCode": "215002",
            "communeCode": "25",
            "countyCode": "01"
          }
        ]
      }
    }
  ]
}

Authentication

All requests towards the API's require authentication. This is achieved by using the Consumer key and Consumer secret received from the application registered as subscriber on the developer site and calling the token service:

Use the following example to generate an access token using the client_credentials grant type.

curl request

curl -k -d "grant_type=client_credentials" \
                    -H "Authorization: Basic Base64(consumer-key:consumer-secret)" \
                     https://api.roaring.io/token

csharp request

var client = new RestClient("https://api.roaring.io/token");
var request = new RestRequest(Method.POST);
request.AddHeader("cache-control", "no-cache");
request.AddHeader("content-type", "application/x-www-form-urlencoded");
request.AddHeader("authorization", "Basic Base64(consumer-key:consumer-secret)");
request.AddParameter("application/x-www-form-urlencoded", "grant_type=client_credentials", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);                        

java request

OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
RequestBody body = RequestBody.create(mediaType, "grant_type=client_credentials");
Request request = new Request.Builder()
  .url("https://api.roaring.io/token")
  .post(body)
  .addHeader("authorization", "Basic Base64(consumer-key:consumer-secret)")
  .addHeader("content-type", "application/x-www-form-urlencoded")
  .addHeader("cache-control", "no-cache")
  .build();

Response response = client.newCall(request).execute();

php request

<?php

$request = new HttpRequest();
$request->setUrl('https://api.roaring.io/token');
$request->setMethod(HTTP_METH_POST);

$request->setHeaders(array(
  'Cache-Control' => 'no-cache',
  'Content-Type' => 'application/x-www-form-urlencoded',
  'authorization' => 'Basic Base64(consumer-key:consumer-secret)'
));

$request->setContentType('application/x-www-form-urlencoded');
$request->setPostFields(array(
  'scope' => 'PRODUCTION',
  'grant_type' => 'client_credentials'
));

try {
  $response = $request->send();

  echo $response->getBody();
} catch (HttpException $ex) {
  echo $ex;
}                           

Where Base64(consumer-key:consumer-secret) is a placeholder for the actual base64 encoded version of the string "consumer-key" + "consumer-secret". This will return an OAuth token with a validity time according to the settings you have made, a response example:

Example response

{
   "access_token": "d4c7d9a8-eb5f-34fb-b7b6-2acaad1cdd86",
   "scope": "am_application_scope default",
   "token_type": "Bearer",
   "expires_in": 3600
}

The access_token received must then be used when calling the API by sending it in the request (Authorization) header:

Authorization : Bearer e6a59442-h1s5-31da-8032-0b0ba88a1y04

On the application page on the developer site there are also several code snippet examples for token creation in common programming languages.

Security at Roaring

Security is very important for us at Roaring. If you have any questions after reading this, or encounter any issues, please let us know.

Payments and credit card management

All payment and creditcard handling is done using our payment provider Stripe which has been audited by a PCI-certified auditor and is certified to PCI Service Provider Level 1 Visa. For more information about security at Stripe.

HTTPS for secure connections Roaring forces HTTPS for all services using TLS (SSL), including the developer portal and all the apis.

We regularly audit the details of our implementation: the certificates we serve, the certificate authorities we use, and the ciphers we support.

API Authentication and Authorization

We are using the Oauth2 framework for authentication and authorization in our API's. for more information about how this flow works, please take a look at our authentication flow documentation.

Questions?

We're always happy to help with code or any other questions you might have! Look through our documentation or contact support.

Person

Sweden

Person

Contains information about all persons registered in Sweden. Used for customer registration, registry update, control of persons, etc.

Endpoint

Get current person information

https://api.roaring.io/person/1.0/person

Get historical person information (3 years)

https://api.roaring.io/person/1.0/personhistory

Get current and historical person information

https://api.roaring.io/person/1.0/personfull

Detailed data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer site

Model Explanation
Person
nationalRegistryChangeDate
string, optional
Date for latest change in national registry
actualPersonalNumber
boolean, optional
Indication on if this is an active personal number
personalNumber
string, optional
The personal number identifying a person in Sweden
hasHistory
boolean, optional
Information on if there are any historical information available for this person. If "true" you can get the historical data with the API; GET /personhistory.
secrecyChangeDate
string, optional
Date for change of secrecy marking
secrecyMarked
boolean, optional
The consumer's information is protected and will not be returned. Any previously stored information should be removed in compliance with local laws.
details
Array[Details], optional
Person details like names and birthdate, includes dates for when the detailed information is valid
address
(Address, optional)
relation
Array[Relation], optional)
Information about persons that have a relation to this person
taxationYear
string, optional
Taxation year (YYYY)
aggregatedIncome
string, optional
Summed up income for the year expressed in taxationYear
realEstate
Array[RealEstate], optional)
List of real estate owned by the person
Details
dateFrom
string, optional
Date from which these details are valid
dateTo
string, optional
Date to which these details are valid
notificationName
string, optional
Middle name, first name and surname together in that order
firstName
string, optional
All first names of this person.
givenName
(integer, optional)
A code that show which of the first names that is used as calling name.
middleName
string, optional
All middle names of this person
surName
string, optional
Surname is the person's family name (last name).
gender
string, optional
The gender this person identifies as. Either F (female) or M (male)
birthDate
string, optional
Date of birth in accordance with ISO 8601 date, i.e. YYYY-MM-DDThh:mm
birthCongregation
string, optional
two digit code for the congregation the person was born in
birthCountyCode
string, optional
two digit code for the county the person was born in
deRegistrationDate
string, optional
Date for deregistration from the national registry
deRegistrationReason
string, optional
Reason for deregestering from the national registry, represented as a code
personalNumberChangedFrom
string, optional
Old personal number after a switch
personalNumberChangedTo
string, optional
The new personal number after a switch
swedishCitizen
boolean, optional
A code showing whether the person is a Swedish citizen or not.
secrecyMarked
boolean, optional
A code showing if the persons's information is protected or not. If the persons' information is protected it will not be returned.
Address
foreignAddress
Array[ForeignAddress], optional
List of foreign addresses recorded for the person
nationalRegistrationAddress
Array[NationalRegistrationAddress], optional
List of national registration addresses recorded for the person
specialPostAddress
Array[SpecialPostAddress], optional)
List of special postal addresses recorded for the person
Relation
birthDate
string, optional
Birth date for the related person. Can be incomplete or missing
dateFrom
string, optional
Date from which this relation is/was active
dateTo
string, optional
Date to which this relation is/was active
deRegistrationDate
string, optional
Date for deregistration from the national registry for the related person
deRegistrationReason
string, optional
Code describing reason for deregistration
firstName
string, optional
First name for a related person that is missing a personal number
middleName
string, optional
Middle name for a related person that is missing a personal number
personalNumber
string, optional
Personal number for the related person. Can be missing for a non registered related person
relationType
string, optional
Code for relation type V = guardian. M = husband, wife or partner
surName
string, optional
Surname for a related person that is missing a personal number
RealEstate
changeDate
string, optional
Date for change of real estate information
communeCode
string, optional
Commune where the real estate resides
countyCode
string, optional
County where the real estate resides
realEstateCode
string, optional
Code describing type of real estate
shareDenominator
string, optional
Share of ownership, Denominator
shareNominator
string, optional
Share of ownership, Nominator
taxationValue
string, optional
The real estates calculated taxation value
taxationYear
string, optional
Latest year the real estate was taxed (YYYY)
ForeignAddress
dateFrom
string, optional
Date from which the address is/was in use
dateTo
string, optional
Date to which the address is/was in use
careOf
string, optional
The "care of"-line (c/o) if any. E.g. c/o 'Adam Eriksson'
city
string, optional
The postal city name. E.g. 'Sundbyberg'
country
string, optional
Country e.g. 'Norway'
deliveryAddress1
string, optional
First line for physical address information such as street name and number
deliveryAddress2
string, optional
Second line for physical address information such as street name and number, e.g. Sturegatan 5
deliveryAddress3
string, optional
Third extra line for foreign address information
NationalRegistrationAddress
dateFrom
string, optional
Date from which the address is/was in use
dateTo
string, optional
Date to which the address is/was in use
registrationDate
string, optional
Registry registration date
careOf
string, optional
The "care of"-line (c/o) if any. E.g. c/o 'Adam Eriksson'
deliveryAddress1
string, optional
First line for address information, e.g. 'Sturegatan 5'
deliveryAddress2
string, optional
Second line for address information, e.g. 'LGH 3214'
postalNumber
string, optional
The postal code number (zip code). E.g. '16974'
city
string, optional
The postal city name. E.g. 'Sundbyberg'
districtCode
string, optional
Code for the district
congregationCode
string, optional
Code for congregation
communeCode
string, optional
Code for commune
countyCode
string, optional
Code for county
SpecialPostAddress
dateFrom
string, optional
Date from which the address is/was in use
dateTo
string, optional
Date to which the address is/was in use
careOf
string, optional
The "care of"-line (c/o) if any. E.g. c/o 'Adam Eriksson'
city
string, optional
The postal city name. E.g. 'Sundbyberg'
deliveryAddress1
string, optional
First line for special postal address information
deliveryAddress2
string, optional
Second line for special postal address information
postalNumber
string, optional
The postal code number (zip code). E.g. '16974'

Apply for Production Data

Get started

Authorization Types

Information about persons in SPAR
The national registry contains the following information about persons.

The national registry can also contain information that a person has demanded a block against receiving direct mail with SPAR as the address source.

Authorization types
What information can you access?

In our data source SPAR, there are several different authorization types regarding the information that you are allowed to receive.

Roaring can help you with the authorization application process towards Skatteverket.

Basic Permission
Basic authorization most organizations have a right to includes the nameof the person, address, national registry commun, personal identity number (personal number or co-ordination number), date of birth and gender.

Citizenship
Organizations entitled to have access to citizenship is CSN, Bolagsverket, Polisen, SÄPO and Tullverket.

Relations
Relations to husband / wife / partner or guardians. Authorization is given to authorities, banks, insurance companies, mutual fund companies and others.

Origin of Birth
The authorization contains information about the birth place of origin. Authorization is given to Polismyndigheten, Säkerhetspolisen and Tullverket.

Income and Real Estate
The authorization contains information about taxed income, income from capital and data about real estate regarding single-family units such as place and taxation value. Authorization is given to Polismyndigheten, Säkerhetspolisen and Tullverket.

Personal Numbers for Test

Example: Notification name | 193701308888

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \
'https://api.roaring.io/person/1.0/person?\
personalNumber=193701308888'

Response

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2010-02-02T00:00",
      "personalNumber": "193701308888",
      "hasHistory": true,
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2010-02-02T00:00",
          "dateTo": "9999-12-31T00:00",
          "notificationName": "Efternamn3542, Christina Birgitta",
          "firstName": "Christina Birgitta Ulrika",
          "givenName": 20,
          "middleName": "Thomeaus",
          "surName": "Efternamn3542",
          "gender": "F",
          "birthDate": "1937-01-30T00:00"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2015-12-18T00:00",
            "dateTo": "9999-12-31T00:00",
            "registrationDate": "2003-01-01T00:00",
            "deliveryAddress2": "Gatan142 8",
            "postalNumber": "11146",
            "city": "STOCKHOLM",
            "districtCode": "215025",
            "communeCode": "80",
            "countyCode": "01"
          }
        ]
      }
    }
  ]
}

This dev person data service fetches test person data information from a database containing ca 6500 fictive persons with various different information types available.

Here are some personal numbers available in the test data to get your testing going.

Type Endpoint  Social security number
Notification name Person 193701308888
National Registration Address Person 192907304766
Special Post Address Person 196805029268
Foreign Address Person 194812161596
History Person 197904182396
Personal Number Changed From Person 199111029196
Personal Number Changed To Person 199111022399
Reason for deregestering from the national registry, represented as a code G Person 199111022399
Reason for deregestering from the national registry, represented as a code A Person 193604139208
Reason for deregestering from the national registry, represented as a code O Person 198512122394
Person is secrecy marked Person 193103249078
Incorrect personal number Person 19360413920
Child with relational data Person  200902102383
No hit in SPAR
National Registration Address History 192907304766
Special Post Address History 196805029268
Foreign Address History 194812161596
History History 197904182396
Personal Number Changed From History 199111029196
Personal Number Changed To History 199111022399
Reason for deregestering from the national registry, represented as a code G History 199111022399
Reason for deregestering from the national registry, represented as a code A History 193604139208
Reason for deregestering from the national registry, represented as a code O History 198512122394
Person is secrecy marked History 193103249078
Incorrect personal number History 19360413920
Physical person ID as a coordination number History 199211629192
Notification name Full 193701308888
National Registration Address Full 192907304766
Special Post Address Full 196805029268
Foreign Address Full 194812161596
History Full 197904182396
Personal Number Changed From Full 199111029196
Personal Number Changed To Full 199111022399
Reason for deregestering from the national registry, represented as a code G Full 199111022399
Reason for deregestering from the national registry, represented as a code A Full 193604139208

Norway

Person

Contains information about all persons registered in Norway. Used for customer registration, registry update, control of persons, etc.

Endpoint

https://api.roaring.io/person/no/1.0

Detailed data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer site

Model Explanation
PersonLookupResponse
posts
Array[Person], optional
Person
importantNote
string, optional
socialSecurityNumber
string, optional
nameChangeCauseCode
string, optional
hasHistory
boolean, optional
memberOfChurch
boolean, optional
showCredentials
boolean, optional
actualPersonalNumber
boolean, optional
Indication on if this is an active personal number
personalNumber
string, optional
The personal number identifying a person in Norway
details
Array[Details], optional
Person details like names and birthdate, includes dates for when the detailed information is valid
address
Address, optional
relations
Relations, optional
newPersonalNumber
PersonalNumberRegistration,
optional
previousPersonalNumber
PersonalNumberRegistration,
optional
status
PersonStatus, optional
citizenship
Array[Citizenship], optional
Details
firstName
string, optional
All first names of this person
middleName
string, optional
All middle names of this person
surName
string, optional
Surname is the person's family name (last name)
surNameNotMarried
string, optional
fullName
string, optional
schoolDistrict
string, optional
constituency
string, optional
basicCircuit
string, optional
gender
string, optional
The gender this person identifies as. Either F (female) or M (male)
birthDate
string, optional
Date of birth in accordance with ISO 8601 date, i.e. YYYY-MM-DDThh:mm
birthTown
string, optional
birthCommuneOrCountry
string, optional
birthCommuneCodeOr
CountryCode

string, optional
registrationDate
string, optional
Registry registration date
same
Same, optional
incapacitated
Incapacitated, optional
residencePermit
ResidencePermit, optional
retention
Retention, optional
Address
moveAddressCauseCode
string, optional
foreignAddress
Array[ForeignAddress], optional
List of foreign addresses recorded for the person
nationalRegistrationAddress
Array[NationalRegistrationAddress],
optional
List of national registration addresses recorded for the person
previousAddresses
Array[PreviousAddress], optional
List of previous registration addresses recorded for the person
homelandAddresses
Array[HomelandAddress], optional
List of homeland registration addresses recorded for the person
specialAddresses
Array[SpecialAddress], optional
List of special registration addresses recorded for the person
Relations
family
Family, optional
maritalStatus
MaritalStatus, optional
mother
PersonIdentity, optional
father
PersonIdentity, optional
children
Array[PersonIdentity], optional
parentalResponsibility
ParentalResponsibility, optional
PersonalNumberRegistration
personalNumber
string, optional
registrationDate
string, optional
Registry registration date
PersonStatus
code
integer, optional
formatted
string, optional
registrationDate
string, optional
Registry registration date
Citizenship
code
string, optional
country
string, optional
registrationDate
string, optional
Registry registration date
Same
enrolled
boolean, optional
registrationDate
string, optional
Registry registration date
Incapacitated
code
string, optional
registrationDate
string, optional
Registry registration date
ResidencePermit
status
string, optional
formatted
string, optional
additionalText
string, optional
duf
string, optional
registrationDate
string, optional
Registry registration date
Retention
status
object, optional
registrationDate
string, optional
Registry registration date
ForeignAddress
careOf
string, optional
The "care of"-line (c/o) if any. E.g. c/o 'Tomas Topstad'
country
string, optional
Country e.g. 'Norway'
countryCode
string, optional
Country code e.g. '000'
moveToForeignDate
string, optional
Date when moved to foreign address
**type string, optional
registrationDate
string, optional
Registry registration date
deliveryAddress1
string, optional
First line for physical address
deliveryAddress2
string, optional
Second line for physical address
deliveryAddress3
string, optional
Third extra line for foreign address information
NationalRegistrationAddress
registrationDate
string, optional
Registry registration date
moveToDate
string, optional
Registry move date
careOf
string, optional
The "care of"-line (c/o) if any. E.g. c/o 'Tomas Topstad'
districtCode
string, optional
congregationCode
string, optional
communeCode
string, optional
communeName
string, optional
residentialNumber
string, optional
requisitionName
string, optional
requisitionNumber
string, optional
countyCode
string, optional
floorNumber
string, optional
addressType
AddressType, optional
PreviousAddress
country
string, optional
countryCode
string, optional
moveFromRegistrationDate
string, optional
moveFromForeignCountry
RegistrationDate

string, optional
moveFromForeign
CountryDate

string, optional
registrationDate
string, optional
Registry registration date
moveFromDate
string, optional
moveFromCommuneCode
string, optional
moveFromCommuneName
string, optional
moveFromForeignCountry
string, optional
moveFromForeignCountryCode
string, optional
HomelandAddress
country
string, optional
countryCode
string, optional
deliveryAddress1
string, optional
deliveryAddress2
string, optional
deliveryAddress3
string, optional
registrationDate
string, optional
Registry registration date
SpecialAddress
code
integer, optional
formatted
string, optional
registrationDate
string, optional
Registry registration date
Family
number
string, optional
personCode
string, optional
personCodeFormatted
string, optional
registrationDate
string, optional
Registry registration date
MaritalStatus
code
integer, optional
formatted
string, optional
causeCode
string, optional
registrationDate
string, optional
Registry registration date
PersonIdentity
countryCode
string, optional
country
string, optional
name
string, optional
gender
string, optional
personalNumber
string, optional
birthDate
string, optional
ParentalResponsibility
countryCode
string, optional
formatted
string, optional
registrationDate
string, optional
Registry registration date
AddressType
code
integer, optional
0 = Official, 1 = Property
formatted
string, optional
code formatted
property
PropertyRegister, optional
official
OfficialRegister, optional
PropertyRegister
holdingNumber
string, optional
subHoldingNumber
string, optional
leaseNumber
string, optional
OfficialRegister
houseNumber
string, optional
streetNumber
string, optional
addressLetter
string, optional 

Apply for Production Data

Get started To get started and get access to production data from Det Sentrale Folkeregister (DSF) you need to create an account with us and fill in a few documents. Contact us and we will help you with the application process.

Personal Numbers for Test

Example: Resident | 20119800324 |Kavli | Stian

{
  "posts": [
    {
      "actualPersonalNumber": true,
      "personalNumber": "20119800324",
      "status": {
        "code": 1,
        "formatted": "Resident"
      },
      "hasHistory": false,
      "secrecyMarked": false,
      "details": [
        {
          "birthDate": "1998-11-20",
          "firstName": "STIAN",
          "surName": "KAVLI",
          "middleName": "FOS",
          "fullName": "KAVLI STIAN FOS",
          "gender": "M"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "registrationDate": "2000-02-25",
            "deliveryAddress1": "ETTERSTAD",
            "postalNumber": "0603",
            "city": "OSLO",
            "communeCode": "0018",
            "communeName": "REFKOM1",
            "addressType": {
              "code": 1,
              "formatted": "Property",
              "property": {
                "holdingNumber": "00018",
                "subHoldingNumber": "0018"
              }
            },
            "moveToDate": "2000-02-25"
          }
        ],
        "specialAddresses": [
          {
            "code": 0,
            "formatted": "Ordinary resident"
          }
        ]
      },
      "citizenship": [
        {
          "code": "000",
          "country": "NORSK"
        }
      ]
    }
  ],
  "source": "Det Sentrale Folkeregister (DSF)"
}

Example: No hit in DSF

{
  "message": "NoRecordsFound",
  "error": "There were no records matching the search parameters"
}

This dev person data service fetches test person data information from a database containing 10 fictive persons with various different information types available.

Here are some fictional persons available in the test data to get your testing going.

Type date of birth last name first name
Death  31120000767 Johansen Bror
Resident  20119800324 Kavli Stian
Resident  22100250539 Otterli Roy
Resident 19066600109 Os Ove 
Resident 19066600370 Muren Magne
Expat  17056800344 Fallet Henrik
Resident 20067900562 Gjestvang Eirik
Disappeared 13084000374 Rud Svein
Disappeared 01017700568 Nilsen Kristian
Canceled Access 07087000405 Hageland  Inger

Company

Sweden

The Company Search API has several usecases. It is used for example, to search for individual companies or to select a target group of companies based on a number of different parameters.

Request parameters

Model Explanation
companyName
boolean, optional
Company name
town
boolean, optional
Postal address town e.g. Stockholm
county
boolean, optional
Postal address county e.g. Stockholm County
zip
boolean, optional
Postal address zipcodes
industryCode
boolean, optional
Company main industry NACE code
legalGroupCode
boolean, optional
Company type code
vatReg
boolean, optional
Company is registered for VAT (MOMS Sweden)
statusCode
boolean, optional
Company status code
employerContributionReg
boolean, optional
companyRegistrationDate
boolean, optional
netTurnover
boolean, optional
Net turnover
numberEmployees
boolean, optional
Number of employees (pcs)

Detailed data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer portal.

Endpoint

https://api.roaring.io/se/company/search/1.1

Atributes

Model Explanation
status
integer, optional
0 or 1. 0 if theres too many hits in order to render request links and samples
hitCount
integer, optional
Total hit count
samples
Array[inline_model], optional
Array of hits on the search
requests
Array[inline_model_0], optional
Array of request links
companyName
string, optional
Name of the company
legalGroupCode
string, optional
Which kind of company it is
legalGroupText
string, optional
Description of which kind of company it is
links
Array[Inline Model 1], optional
array of api-links to fetch information on the company
type
string, optional
Name of API the link points to
method
string, optional
API verb
url
string, optional
URL link to the API call for retrieving information on the company
payload
Inline Model 2, optional
type
string, optional
Name of API the link points to
method
string, optional
API verb
url
string, optional
URL link to the API call for retrieving information on the company
requestKey
string, optional

Example response

The Company Search service retrieves production data. This means that all companies are searchable even in the sandbox.

Search parameters for Test

Example Response | zipCode = 41121 | legalGroupCode = AB | statusCode = 100 | companyRegistrationDate = 1994-12-12

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \
'https://api.roaring.io/se/company/search/1.1/search? \
zipCode=41121&legalGroupCode=AB&statusCode=100& \
companyRegistrationDate=1994-12-12'

Response

{
  "hitCount": 1,
  "samples": [
    {
      "companyName": "Wilfast Högsbo Aktiebolag",
      "legalGroupCode": "AB",
      "legalGroupText": "Privat aktiebolag",
      "town": "GÖTEBORG",
      "links": [
        {
          "type": "company_economy_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/economy-overview/_re2f2ff73897504ea8b0f6558524dfb56"
        },
        {
          "type": "company_establishments",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/establishment/_re2f2ff73897504ea8b0f6558524dfb56"
        },
        {
          "type": "company_signatory",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/signatory/_re2f2ff73897504ea8b0f6558524dfb56"
        },
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/overview/_re2f2ff73897504ea8b0f6558524dfb56"
        },
        {
          "type": "company_board_members",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/board-members/_re2f2ff73897504ea8b0f6558524dfb56"
        }
      ]
    }
  ],
  "requests": [
    {
      "type": "company_economy_overview",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/economy-overview",
      "payload": {
        "requestKey": "086fe11d-db9d-47a2-a3fd-cb7601545b92"
      }
    },
    {
      "type": "company_establishments",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/establishment",
      "payload": {
        "requestKey": "086fe11d-db9d-47a2-a3fd-cb7601545b92"
      }
    },
    {
      "type": "company_signatory",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/signatory",
      "payload": {
        "requestKey": "086fe11d-db9d-47a2-a3fd-cb7601545b92"
      }
    },
    {
      "type": "company_overview",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/overview",
      "payload": {
        "requestKey": "086fe11d-db9d-47a2-a3fd-cb7601545b92"
      }
    },
    {
      "type": "company_board_members",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/board-members",
      "payload": {
        "requestKey": "086fe11d-db9d-47a2-a3fd-cb7601545b92"
      }
    }
  ],
  "status": 1
}
Legalform Swedish Company name Town Organizational number
Kommanditbolag Kommanditbolaget Porsen 17 Sjömarken 9168937861
Stiftelse Stiftelsen John Söderbergs fond Stockholm 8024045489
Ideell förening Torekovs föreläsningsförening Båstad 8394004322
Aktiebolag Wilfast Högsbo Aktiebolag Göteborg 5565002465
Aktiebolag Swedec AB Trollhättan 5567164818

Simple Search (Deprecated)

The SimpleSearch API is a simple feature for searching a Swedish company using company names.

Detailed data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer portal.

Endpoint

https://api.roaring.io/se/company/simple-search/1.0

Attributes

Model Explanation
moreHits
boolean, optional
True if there are more hits then the returned max of 20
hitCount
integer, optional
Number of hits
matches
Array[inline_model], optional
Array of hits on the search
companyName
string, optional
Name of the company
legalGroupCode
string, optional
Which kind of company it is
legalGroupText
string, optional
Description of which kind of company it is
links
Array[Inline Model 1], optional
array of api-links to fetch information on the company
type
string, optional
Name of API the link points to
method
string, optional
API verb ,
url
string, optional
URL link to the API call for retrieving information on the company

Example response

The Simple Search service retrieves production data. This means that all companies are searchable even in the sandbox.

Search parameters for Test

Example Response | Wilfast Högsbo Aktiebolag, Göteborg

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \
'https://api.roaring.io/se/company/simple-search/1.0/\
search?name=name=Wilfast%20H%C3%B6gsbo%20Aktiebolag&town=G%C3%B6teborg'

Response

{
  "moreHits": false,
  "hitCount": 1,
  "matches": [
    {
      "companyName": "Wilfast Högsbo Aktiebolag",
      "legalGroupCode": "AB",
      "legalGroupText": "Privat aktiebolag",
      "town": "GÖTEBORG",
      "links": [
        {
          "type": "company_economy_overview",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-economy-overview?countryCode=se&companyId=5565002465"
        },
        {
          "type": "company_establishments",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/establishment/5565002465"
        },
        {
          "type": "company_signatory",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-signatory?countryCode=se&companyId=5565002465"
        },
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-overview?countryCode=se&companyId=5565002465"
        },
        {
          "type": "company_board_members",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-board-members?countryCode=se&companyId=5565002465"
        }
      ]
    }
  ]
}
Legalform Swedish Company name Town Organizational number
Kommanditbolag Kommanditbolaget Porsen 17 Sjömarken 9168937861
Bostadsrättsförening Bostadsrättsföreningen Kamelian 4 Stockholm 7696053631
Stiftelse Stiftelsen John Söderbergs fond Stockholm 8024045489
Ideell förening Torekovs föreläsningsförening Båstad 8394004322
Aktiebolag Wilfast Högsbo Aktiebolag Göteborg 5565002465
Aktiebolag Swedec AB Trollhättan 5567164818
Aktiebolag Aronfors Bygg och Teknik Aktiebolag Munkedal 5564866803
Aktiebolag Atsol AB Malmö 5569994600
Aktiebolag ACM 2001 AB Stockholm 5560572850

Overview

Company Overview API contains basic information about all companies in Sweden.

Used for CRM, prospecting, mailing, delivery information and verification that the company is registered for tastring optionalx.

Common use-cases:

Endpoint

https://api.roaring.io/se/company/overview/1.1/

Detailed data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer site

Model Explanation
companyId
string optional
Company identifier (company registration number / organization number)
changeDate
string optional
Date for when the record was last changed
statusCode
string optional
Company status code
statusTextHigh
string optional
Company status text
statusTextDetailed
string optional
Company status text detailed
statusDateFrom
string optional
Company status date from
companyName
string optional
Company name
coAddress
string optional
Postal address C/O address
address
string optional
Postal address street/P.O BOX
zipCode
string optional
Postal address zipcode
town
string optional
Postal address town
commune
string optional
Postal address commune name
county
string optional
Postal address county
visitAddress
string optional
Visiting address street name street number and unit
visitStreet
string optional
Visiting address street
visitStreetNumber
string optional
Visiting address number
visitStreetUnit
string optional
Visiting address unit
visitZipCode
string optional
Visiting address zip code
visitTown
string optional
Visiting address town
visitCommune
string optional
Visiting address commune
visitCounty
string optional
Visiting address county
phoneNumber
string optional
Telephone number
faxNumber
string optional
Fax number
email
string optional
Email address
webAddress
string optional
Web address
legalGroupCode
string optional
Company type code
legalGroupText
string optional
Company type text
preliminaryTaxReg
string optional
Company is approved for preliminary tax (F-skatt Sweden)
employerContributionReg
string optional
Company is registererd for employer contribution tax (Arb.avg Sweden)
vatReg
string optional
Company is registered for VAT (MOMS Sweden)
vepChangedDate
string optional
Show the latest date any of preliminaryTaxReg employerContributionReg or vatReg has had a change
companyRegistrationDate
string optional
Company registration date
companyDeregistrationDate
string optional
Company deregistration date
industryCode
string optional
Company main industry NACE code
industryText
string optional
Company main industry NACE text
topDirectorName
string optional
Top director's name
topDirectorFunction
string optional
Top director's function
numberCompanyUnits
string optional
Number of company units/workplaces
numberEmployees
string optional
Number of employees (pcs)

Company Status Codes

A list of available status codes for a company is find here

Organization Numbers for Test

Example: Aktiebolag (Active company, not registered for any tax, company code unknown.) | 5565002465

Request

curl -X GET --header 'Accept: application/json' --header 'Authorization: Bearer {ACCESS TOKEN}' 'https://api.roaring.io/se/company/overview/1.1/5565002465'

Response

{
  "companyId": "5565002465",
  "changeDate": "2016-12-10",
  "statusCode": "100",
  "statusTextHigh": "Aktivt",
  "statusTextDetailed": "Aktivt",
  "statusDateFrom": "20130401",
  "companyName": "Wilfast Högsbo Aktiebolag",
  "severalCompanyName": false,
  "address": "Stora Badhusgatan 28 A",
  "zipCode": "41121",
  "town": "GÖTEBORG",
  "commune": "GÖTEBORG",
  "county": "VÄSTRA GÖTALAND",
  "phoneNumber": "031-171300",
  "legalGroupCode": "AB",
  "legalGroupText": "Privat aktiebolag",
  "preliminaryTaxReg": "0",
  "companyRegistrationDate": "1994-12-12",
  "industryCode": "00009",
  "industryText": "Huvudnäring okänd",
  "numberEmployees": "0"
}

Example: POST example | 5565002465, 5569994600

Request

curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Bearer {ACCESS TOKEN}' -d '{ \ 
   "companyIds": ["5565002465","5569994600"] \ 
 }' 'https://api.roaring.io/se/company/overview/1.1/'

Response

{
  "responseInfo": {
    "requestCount": 2,
    "hitCount": 2,
    "noMatchIds": []
  },
  "companies": [
    {
      "companyId": 5565002465,
      "changeDate": "2016-12-10",
      "statusCode": 100,
      "statusTextHigh": "Aktivt",
      "statusTextDetailed": "Aktivt",
      "statusDateFrom": 20130401,
      "companyName": "Wilfast Högsbo Aktiebolag",
      "severalCompanyName": false,
      "address": "Stora Badhusgatan 28 A",
      "zipCode": 41121,
      "town": "GÖTEBORG",
      "commune": "GÖTEBORG",
      "county": "VÄSTRA GÖTALAND",
      "phoneNumber": "031-171300",
      "legalGroupCode": "AB",
      "legalGroupText": "Privat aktiebolag",
      "preliminaryTaxReg": 0,
      "companyRegistrationDate": "1994-12-12",
      "industryCode": "00009",
      "industryText": "Huvudnäring okänd",
      "numberEmployees": 0
    },
    {
      "companyId": 5569994600,
      "changeDate": "2016-12-10",
      "statusCode": 100,
      "statusTextHigh": "Aktivt",
      "statusTextDetailed": "Aktivt",
      "statusDateFrom": 20150105,
      "companyName": "Atsol AB",
      "severalCompanyName": false,
      "address": "Norra Parkgatan 3, Lgh 1402",
      "zipCode": 21153,
      "town": "MALMÖ",
      "commune": "MALMÖ",
      "county": "SKÅNE",
      "visitAddress": "Roskildevägen",
      "visitStreet": "Roskildevägen",
      "visitZipCode": 21147,
      "visitTown": "Malmö",
      "visitCommune": "MALMÖ",
      "visitCounty": "SKÅNE",
      "legalGroupCode": "AB",
      "legalGroupText": "Privat aktiebolag",
      "preliminaryTaxReg": 1,
      "employerContributionReg": 1,
      "vatReg": 1,
      "vepChangedDate": 20150708,
      "companyRegistrationDate": "2015-01-05",
      "industryCode": 64993,
      "industryText": "Förvaltning av och handel med värdepapper för en begränsad och sluten krets av ägare",
      "numberCompanyUnits": 1,
      "numberEmployees": 1
    }
  ]
}

This dev company data service fetches test company data information from a database containing a set of fictive companies with various different information types available.

Here are some company ID numbers available in the test data to get your testing going.

Note that this is test data. The information shown is per 2017-03-20. Thus, information will change over time and can disappear. These are only examples of the responses you can receive in production.

Legalform Swedish Type of test case Organizational number
Kommanditbolag 9168937861
Bostadsrättsförening 7696053631
Samfällighetsförening 717913520
Stiftelse 8024045489
Ideell förening 8394004322
Aktiebolag (Active company, not registered for any tax, company code unknown.) 5565002465
Aktiebolag (Active company, registered for tax.) 5567164818
Aktiebolag (Active company, registered for tax.) 5564866803
Aktiebolag (Active company, registered for tax, head office.) 5569994600
Aktiebolag (Liquidation approved, C/O address) 5590506506
Aktiebolag (Active company, merger completed.) 5560572850
Aktiebolag (Bankruptcy) 5569030264
Enskild firma 7904182396
Enskild firma 6805029268
POST example 5565002465, 5569994600

Economy Overview

Company Economy API contains financial key information so you can get a good picture of the company's financial position.

Used for prospecting and to be included in a decision to initiate a business relationship with a customer or supplier.

Common use-cases:

Endpoint

https://api.roaring.io/se/company/economy-overview/1.1/

Detailed data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer site

Model Explanation
companyId
string, optional
Company identifier (company registration number / organization number)
changeDate
string, optional
Date for when the record was last changed
bsShareCapital
string, optional
Shared capital
nbrOfEmployees
string, optional
Number of employees
nbrOfEmployeesInterval
string, optiona
Number of employees interval
nbrOfEmployeesOfficeInterval
string, optional
Number of employees office interval
netTurnover
string, optional
Net turnover
turnoverInterval
string, optional
Turnover interval
turnoverPerEmployee
string, optional
Turnover per employee
plOperatingProfit
string, optional
Pl operating Profit
plProfitLossAfterFinItems
string, optional
Pl after financial items
string, optional
bsTotalEquity
string, optional
Bs Total Equity
bsTotalAssets
string, optional
Bs Total assets
bsCashAndBankBalances
string, optional
Bs Cash And Bank Balances
kpiSolidityPercent
string, optional
Kpi Solidity Percent
kpiQuickRatioPercent
string, optional
Kpi Quick Ratio Percent
kpiNetMarginPercent
string, optional
Kpi Net Margin Percent

Organization Numbers for Test

Example: Aktiebolag (Active company, not registered for any tax, company code unknown.) | 5565002465

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: {ACCESS TOKEN}' \
'https://api.roaring.io/se/company/economy-overview/1.1/5565002465'

Response

{
  "companyId": "5565002465",
  "changeDate": "2016-12-10",
  "bsShareCapital": "100",
  "nbrOfEmployees": "0",
  "nbrOfEmployeesInterval": "0 anställda",
  "nbrOfEmployeesOfficeInterval": "Okänt antal kontorsanställda",
  "netTurnover": "0",
  "turnoverPerEmployee": "0",
  "plOperatingProfit": "-7",
  "plProfitLossAfterFinItems": "-7",
  "plNetIncome": "-7",
  "bsTotalEquity": "121",
  "bsTotalAssets": "127",
  "bsCashAndBankBalances": "41",
  "kpiSolidityPercent": "95.3",
  "kpiQuickRatioPercent": "2116.7",
  "kpiNetMarginPercent": "0"
}

This dev company data service fetches test company data information from a database containing a set of fictive companies with various different information types available.

Here are some company ID numbers available in the test data to get your testing going.

Note that this is test data. Thus, information will change over time and can disappear. These are only examples of the responses you can receive in production.

Legalform Swedish Type of test case Organizational number
Kommanditbolag 9168937861
Bostadsrättsförening 7696053631
Samfällighetsförening 717913520
Stiftelse 8024045489
Ideell förening 8394004322
Aktiebolag (Active company, not registered for any tax, company code unknown.) 5565002465
Aktiebolag (Active company, registered for tax.) 5567164818
Aktiebolag (Active company, registered for tax.) 5564866803
Aktiebolag (Active company, registered for tax, head office.) 5569994600
Aktiebolag (Liquidation approved, C/O address) 5590506506
Aktiebolag (Active company, merger completed.) 5560572850
Aktiebolag (Bankruptcy) 5569030264

Establishments

Company Economy API contains information about a Swedish company's workplaces, i.e. a company's geographic workplaces. Is used to keep track of a company's different workplaces and delivery addresses.

Common use-cases:

Endpoint

https://api.roaring.io/se/company/establishment/1.0/

Detailed data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer site

Model Parameters
companyId
string, optional
Company identifier (company registration number / organization number)
changeDate
string, optional:
Date for when the record was last changed
establishments
Array[inline_model], optional
Array of establishments for the requested company
companyEstablishmentNumber
string,
A specific Company Establishment Number also knowns as CFAR
establishmentOfficeName
string, optional
Name of the office eg. headquarters or store.
establishmentOfficeType
string, optional
Type of office eg. warehouse
establishmentCoAddress
string, optional
Postal address C/O address
establishmentAddress
string, optional
Postal address street/P.O BOX
establishmentZipCode
string, optional
Postal address zipcode
establishmentTown
string, optional
Postal address town
establishmentVisitAddress
string, optional
Visiting address street
establishmentVisitZipCode
string, optional
Visiting address zip code
establishmentVisitTown
string, optional
Visiting address town
phoneNumber
string, optional
Telephone number
faxNumber
string, optional
Fax number
email
string, optional
Email address
industryCode
string, optional
Company main industry NACE code
industryText
string, optional
Company main industry NACE text

commercialBlockText
string, optional numberEmployeesInterval
string, optional | Number of employees in interval

Organization Numbers for Test

Example: Aktiebolag (Active company, registered for tax.) | 5567164818

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \
'https://api.roaring.io/se/company/establishment/1.0/5567164818'

Response

{
  "companyId": "5567164818",
  "changeDate": "2016-12-10",
  "establishments": [
    {
      "companyEstablishmentNumber": "46803870",
      "establishmentOfficeName": "Swedec AB",
      "establishmentOfficeType": "Huvudkontor",
      "establishmentAddress": "Åkerssjövägen 52",
      "establishmentZipCode": "46153",
      "establishmentTown": "Trollhättan",
      "establishmentVisitAddress": "Åkerssjövägen 52",
      "establishmentVisitZipCode": "46153",
      "establishmentVisitTown": "Trollhättan",
      "phoneNumber": "0706-646428",
      "industryCode": "70100",
      "industryText": "Administrativ företagsverksamhet",
      "commercialBlockText": "Tar emot reklam",
      "numberEmployeesInterval": "1-4 anställda"
    }
  ]
}

This dev company data service fetches test company data information from a database containing a set of fictive companies with various different information types available.

Here are some company ID numbers available in the test data to get your testing going.

Note that this is test data. Thus, information will change over time and can disappear. These are only examples of the responses you can receive in production.

Legalform Swedish Type of test case Organizational number
Bostadsrättsförening 7696053631
Ideell förening 8394004322
Aktiebolag Active company, registered for tax. 5567164818
Aktiebolag Active company, registered for tax. 5564866803
Aktiebolag Active company, registered for tax, head office. 5569994600
Aktiebolag Active company, merger completed. 5560572850

Engagements

Company Engagements API contains information about the corporate engagement a particular person has. Used to connect a person to different companies or companies.

Common use-cases:

Endpoint

https://api.roaring.io/se/company/engagement/1.0/

Detailed data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer site

Model Explanation
personalNumber
string, optional
Personal identity number and co-ordination number.
hitCount
integer, optional
Number of hits
engagements
Array[inline_model], optional
Array of engagements for the requested company
companyId
string, optional
Company identifier (company registration number / organization number)
changeDate
string, optional
Date for when the record was last changed
companyName
string, optional
Company name
statusCode
integer, optional
Company status code
statusText
string, optional
Company status text
roleCode
integer, optional
Code for type of role
roleName
string, optional
Name of the office
town
string, optional
Postal address town

Role codes

Code Role
1 Arbetstagarrepresentant
2 Extern firmatecknare
3 Extern verkställande direktör
4 Extern vice verkställande direktör
5 Ledamot
6 Likvidator
7 Likvidatorssuppleant
8 Revisor
9 Revisorssuppleant
10 Suppleant
12 Verkställande direktör
13 Vice verkställande direktör
14 Bolagsman
15 Kommanditdelägare
16 Komplementär
18 Ordförande
20 Prokurist
21 Huvudansvarig revisor
22 Lekmannarevisor
23 Lekmannarevisorssuppleant
24 Ställföreträdande VD
25 Verkställande ledamot
26 Vice ordförande
27 Särskild delgivningsmottagare
28 Aktuarie
29 Utlandsbosatt inom EES
30 Utlandsbosatt utanför EES
31 Försäkringsrepresentant

Personal Numbers for Test

Example: 193701308888

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \
'https://api.roaring.io/se/company/engagement/1.0/193701308888'

Response

{
  "hitCount": 2,
  "personalNumber": "193701308888",
  "engagements": [
    {
      "companyId": "5560572850",
      "companyName": "ACM 2001 AB",
      "statusCode": 141,
      "statusText": "Aktivt",
      "roleCode": 18,
      "roleName": "Ordförande",
      "town": "STOCKHOLM"
    },
    {
      "companyId": "5567164818",
      "companyName": "Swedec AB",
      "statusCode": 100,
      "statusText": "Aktivt",
      "roleCode": 10,
      "roleName": "Suppleant",
      "town": "TROLLHÄTTAN"
    }
  ]
}

This dev company data service fetches test company data information from a database containing a set of fictive persons with various different information types available.

Here are some personal indentity numbers available in the test data to get your testing going.

Note that this is test data. Thus, information will change over time and can disappear. These are only examples of the responses you can receive in production.

Type Personal identity number
Person 192907304766
Person 196805029268
Person 197904182396
Person 194812161596
Person 193701308888

Board Members

Company Board Members API contains information about the company's executives. Is used for to check who is in the board and other important roles and for CRM and prospecting

Common use-cases:

Endpoint

https://api.roaring.io/se/company/board-members/1.1/

Detailed API data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer site

Model Explanation
companyId
string, optional
Company identifier (company registration number / organization number)
changeDate
string, optional
Date for when the record was last changed
boardMembers
Array[inline_model_0], optional
Array of board members for the requested company
boardMemberCompanyId
string, optional
personalNumber
string, optional
Personal identity number and co-ordination number.
fullName
string, optional
firstName
string, optional
givenName
string, optional
middleName
string, optional
surName
string, optional
roleCode
integer, optional
Code for type of role
roleName
string, optional
Name of the office
fromDate
string, optional
toDate
string, optional

Role codes

Code Role
1 Arbetstagarrepresentant
2 Extern firmatecknare
3 Extern verkställande direktör
4 Extern vice verkställande direktör
5 Ledamot
6 Likvidator
7 Likvidatorssuppleant
8 Revisor
9 Revisorssuppleant
10 Suppleant
12 Verkställande direktör
13 Vice verkställande direktör
14 Bolagsman
15 Kommanditdelägare
16 Komplementär
18 Ordförande
20 Prokurist
21 Huvudansvarig revisor
22 Lekmannarevisor
23 Lekmannarevisorssuppleant
24 Ställföreträdande VD
25 Verkställande ledamot
26 Vice ordförande
27 Särskild delgivningsmottagare
28 Aktuarie
29 Utlandsbosatt inom EES
30 Utlandsbosatt utanför EES
31 Försäkringsrepresentant

Organization Numbers for Test

Example: 5565002465

Request

curl -X GET --header 'Accept: application/json'\
 --header 'Authorization: Bearer {ACCESS TOKEN}' \
 'https://api.roaring.io/se/company/board-members/1.1/5565002465'

Response

{
  "companyId": "5565002465",
  "changeDate": "2016-12-10",
  "boardMembers": [
    {
      "boardMemberCompanyId": "2907304766",
      "personalNumber": "192907304766",
      "firstName": "Helga Viktoria",
      "surName": "Efternamn2609",
      "roleCode": "5",
      "roleName": "Ledamot",
      "fromDate": "1994-12-12"
    },
    {
      "boardMemberCompanyId": "6805029268",
      "personalNumber": "196805029268",
      "firstName": "Petra",
      "surName": "Efternamn2401",
      "roleCode": "10",
      "roleName": "Suppleant",
      "fromDate": "2003-11-01"
    },
    {
      "boardMemberCompanyId": "4812161596",
      "personalNumber": "194812161596",
      "firstName": "Nils Uno",
      "givenName": "Uno",
      "surName": "Efternamn1433",
      "roleCode": "5",
      "roleName": "Ledamot",
      "fromDate": "2003-11-01"
    },
    {
      "boardMemberCompanyId": "7904182396",
      "personalNumber": "197904182396",
      "firstName": "Kuno",
      "surName": "Efternamn2993",
      "roleCode": "5",
      "roleName": "Ledamot",
      "fromDate": "2003-11-01"
    }
  ]
}

This dev company data service fetches test company data information from a database containing a set of fictive persons with various different information types available.

Here are some personal indentity numbers available in the test data to get your testing going.

Note that this is test data. Thus, information will change over time and can disappear. These are only examples of the responses you can receive in production.

Legalform Swedish Type of test case Organizational number
Kommanditbolag 9168937861
Bostadsrättsförening 7696053631
Aktiebolag (Active company, not registered for any tax, company code unknown.) 5565002465
Aktiebolag (Active company, registered for tax.) 5567164818
Aktiebolag (Active company, registered for tax.) 5564866803
Aktiebolag (Active company, registered for tax, head office.) 5569994600
Aktiebolag (Liquidation approved, C/O address) 5590506506
Aktiebolag (Active company, merger completed.) 5560572850
Aktiebolag (Bankruptcy) 5569030264

Beneficial Owner

Beneficial Owner API contains information about the beneficial owner. A beneficial owner is the person or persons who ultimately own or control, for example, a company or association. A true beneficial owner can also be the person (s) who serve someone else to act on them.

Common use-cases:

Endpoint

Get companies Beneficials Owners

https://api.roaring.io/se/beneficialowner/company/{companyId}

Get Beneficial Owner

https://api.roaring.io/se/beneficialowner/person/{personalNumber}

Detailed data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer site

Model Explanation
CompanyResponse
legalEntity
Association, optional
otherAssociation
Association, optional
associationCollected
boolean, optional
falseInformation
boolean, optional
representatives
Array[PersonDetails], optional
beneficialOwners
Array[BeneficialOwner], optional
status
Status, optional
registrationDate
string, optional
Association
companyId
string, optional
Company Id
companyName
string, optional
Name of company
type
Status, optional
PersonDetails
personalNumber
string, optional
Personal number
coordinationNumber
string, optional
Coordination number
birthDate
string, optional
Date of birth
firstNames
Array[string], optional
Array of first names
givenName
string, optional
Given name
middleName
string, optional
Middle name
surName
string, optional
Surname
gdNumber
string, optional
GD number
countryResidence
Status, optional
citizenship
Status, optional
BeneficialOwner
person
PersonDetails, optional
extentOfControl
Status, optional
controlTypes
Array[ControlType], optional
association
Association, optional
Status
code
string, optional
Status code
description
string, optional
Description of status code
ControlType
code
string, optional
Control code
description
string, optional
Description of control code
association
Association, optional

Codes

Citizenship, Country of residence

In addition to the country codes and countries that may occur, the following can also be displayed:

Code Explanation
VETEJ Can not be determined
STATSLOS Stateless (applies only to country of residence)
Code Explanation
AB Aktiebolag
AKASSA Erkänd Arbetslöshetskassa
ANNANJUR Annan typ av juridisk person
BAB Bankaktiebolag
BF Bostadsförening
BRF Bostadsrättsförening
EEIG Europeisk ekonomisk intressegruppering
EK Ekonomisk förening
FAB Försäkringsaktiebolag
FAMSTIFT Familjestiftelse
FOF Försäkringsförening
GB Gruvbolag HB Handelsbolag
IF Ideell förening KB Kommanditbolag
KHF Kooperativ hyresrättsförening
MB Medlemsbank
OFB Ömsesidigt försäkringsbolag
OFFKORP Offentlig korporation
OVRJUR Övriga svenska juridiska personer bildade enligt särskild lagstiftning OVRSTIFT
RTSF Registrerade Trossamfund
SAMF Samfällighetsförening
SB Sparbank
SCE Europakooperativ
SE Europabolag SF Sambruksförening
UNDERFORF Understödsföreningar, försäkringsföreningar
UTLJUR Utländsk juridisk person
Code Explanation
TRUST Trust eller liknande juridisk konstruktion

Status Beneficial Owner

Code Explanation Swedish  Explanation English
FINNS Det finns en eller flera verkliga huvudmän There are one or more beneficial owners
FINNS_EJ Det finns ingen verklig huvudman There is no beneficial owner
EJFASTSTALLD Företaget eller föreningen kan inte komma fram till om det finns någon verklig huvudman eller har inte tillräckligt med uppgifter för att identifiera vem det är The company or association can not judge if there is any benificial owners or do not have enough information to identify who it is.

Extent Of Control

Code Explanation Swedish  Explanation English
INTERVALL1 Mer än 0 % men inte mer än 25 % More than 0% but not more than 25%
INTERVALL2 Mer än 25 % men inte mer än 50 % More than 25% but not more than 50%
INTERVALL3 Mer än 50 % men inte mer än 75 % More than 50% but not more than 75%
INTERVALL4 Mer än 75 % men mindre än 100 % More than 75% but less than 100%
INTERVALL5 100 % 100%

ControlType | Art

Code Explanation
ART10 Personen har kontroll genom aktier, andelar, medlemskap, avtal eller bestämmelse i exempelvis bolagsordning eller stadgar.
ART14 Personen är styrelseledamot eller motsvarande befattningshavare.
ART17 Personen företräder förvaltaren av stiftelsen.
ART20 Personen har rätt att utse eller avsätta mer än hälften av styrelseledamöterna eller motsvarande befattningshavare.
ART25 Personen kan, enligt stiftelseförordnandet, få en väsentlig del av de medel som stiftelsen delar ut. ART30 Personen har kontroll tillsammans med närstående. ART40 Personen har kontroll genom andra företag eller föreningar.
ART70 Personen är instiftare av trusten.
ART71 Personen är förvaltare av trusten eller företrädare för förvaltaren om den är en juridisk person.
ART72 Personen är beskyddare av trusten. ART73 Personen är förmånstagare till trusten.
ART74 Personen utövar kontroll på annat sätt.

Numbers for Test

Example: Companies Beneficials Owners | 5564866803

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \ 
'https://api.roaring.io/se/beneficialowner/1.0/company/5564866803'

Response

{
  "legalEntity": {
    "type": {
      "description": "Aktiebolag",
      "code": "AB"
    },
    "companyId": "5564866803",
    "companyName": "Aronfors Bygg och Teknik Aktiebolag"
  },
  "otherAssociation": {
    "type": {
      "description": "Trust eller liknande juridisk konstruktion",
      "code": "TRUST"
    },
    "companyId": "0000000000",
    "companyName": "Trust Fond 2001"
  },
  "associationCollected": false,
  "falseInformation": false,
  "representatives": [
    {
      "personalNumber": "193701308888",
      "birthDate": "1937-01-30",
      "coordinationNumber": "",
      "firstNames": [
        "Christina", "Birgitta", "Ulrika"
      ],
      "givenName": "Birgitta",
      "middleName": "",
      "surName": "Testsson",
      "citizenship": {
        "description": "Kan inte fastställas",
        "code": "VETEJ"
      },
      "countryResidence": {
        "description": "Statslös",
        "code": "STATSLOS"
      },
      "gdNumber": ""
    }
  ],
  "beneficialOwners": [
    {
      "person": {
        "personalNumber": "196805029268",
        "birthDate": "1968-05-02",
        "coordinationNumber": "",
        "firstNames": [
          "Petra"
        ],
        "givenName": "Petra",
        "middleName": "",
        "surName": "Efternamn2401",
        "citizenship": {
          "description": "Norge",
          "code": "NO"
        },
        "countryResidence": {
          "description": "Sverige",
          "code": "SE"
        },
        "gdNumber": ""
      },
      "extentOfControl": {
        "description": "Mer än 50 % men inte mer än 75 %",
        "code": "INTERVALL3"
      },
      "controlTypes": [
        {
          "description": "Personen har kontroll genom aktier, andelar, medlemskap, avtal eller bestämmelse i exempelvis bolagsordning eller stadgar.",
          "code": "ART10"
        },
        {
          "description": "Personen har kontroll genom andra företag eller föreningar.",
          "code": "ART40",
          "association": {
            "companyId": "5567164818",
            "companyName": "Swedec AB"
          }
        }
      ]
    }
  ],
  "status": {
    "description": "Det finns en eller flera verkliga huvudmän.",
    "code": "FINNS"
  },
  "registrationDate": "2018-01-12T11:26:55.773"
}

Example: Beneficial Owner | 193701308888

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: {ACCESS TOKEN}' \ 
'https://api.roaring.io/se/beneficialowner/1.0/person/193701308888'

Response

{
  "beneficialOwners": [
    {
      "person": {
        "firstNames": [
          "Christina", "Birgitta", "Ulrika"
        ],
        "givenName": "Birgitta",
        "surName": "Efternamn3542"
      },
      "association": {
        "companyId": "5564866803",
        "companyName": "Aronfors Bygg och Teknik Aktiebolag"
      }
    },
    {
      "person": {
        "firstNames": [
          "Christina", "Birgitta", "Ulrika"
        ],
        "givenName": "Birgitta",
        "surName": "Efternamn3542"
      },
      "association": {
        "companyId": "5565002465",
        "companyName": "Wilfast Högsbo Aktiebolag"
      }
    },
    {
      "person": {
        "givenName": [
          "Christina", "Birgitta", "Ulrika"
        ],
        "firstName": "Birgitta",
        "surName": "Efternamn3542"
      },
      "association": {
        "companyId": "5567164818",
        "companyName": "Swedec AB"
      }
    }
  ]
}

This dev company data service fetches test company data information from a database containing a set of fictive persons with various different information types available.

Here are some personal indentity numbers available in the test data to get your testing going.

Note that this is test data. Thus, information will change over time and can disappear. These are only examples of the responses you can receive in production.

Type of test case Number
Companies Beneficials Owners 5564866803
Beneficial Owner 193701308888

Right To Sign

Company Right To Sign API is used to get automated check to confirm if it is the right person you do business with and that they can sign an agreement.

Common use-cases:

Endpoint

https://api.roaring.io/se/company/right-to-sign/1.0

Detailed data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer site

Model Explanation
companyId
string, optional
Company identifier
changeDate
string, optional
Date for latest change on signing rights for company
personalNumber
string, optional
Personal number controled for signing rights
individualSigningRight
boolean, optional
True if person has individual signing rights
signingRightDescription
string, optional
Describes if the person can sign alone or together with others

Organization Numbers for Test

Example: companyId: 5565002465 | personalNumber 19290730476

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \
'https://api.roaring.io/se/company/right-to-sign/1.0\
/single?companyId=5565002465&personalNumber=192907304766'

Response

{
   "companyId": "5565002465",
   "changeDate": "2018-01-10",
   "personalNumber": "192907304766",
   "individualSigningRight": false,
   "signingRightDescription": "Person has the right to sign in conjunction with others"
}

Example: companyId: 5560572850 | personalNumber 193701308888

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \
'https://api.roaring.io/se/company/right-to-sign/1.0\
/single?companyId= 5560572850&personalNumber= 193701308888'

Response

{
   "companyId": "5560572850",
   "changeDate": "2018-01-10",
   "personalNumber": "193701308888",
   "individualSigningRight": true,
   "signingRightDescription": "Person has individual signing rights"
}

This dev company data service fetches test company data information from a database containing a set of fictive comapnies and persons with various different information types available.

Note that this is test data. Thus, information will change over time and can disappear. These are only examples of the responses you can receive in production.

Legalform Swedish  Company ID Personal identity number
Aktiebolag  5565002465 19290730476
Aktiebolag  5560572850 193701308888
Enskild firma 2907304766 2907304766
Enskild firma 7904182396 7904182396

Signing Combinations

Company Signing Combinations API is used to get automate confirmation of which compositions of people that are allowed to sign for the company.

Common use-cases:

Endpoint

https://api.roaring.io/se/company/signing-combinations/1.0/

Detailed data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer site

Model Explanation
companyId
string, optional
Company identifier
changeDate
string, optional
Date for latest change on signing rights for company
personalNumber
string, optional
Personal number controled for signing rights
individualSigningRight
boolean, optional
True if person has individual signing rights
signingRightDescription
string, optional
Describes if the person can sign alone or together with others
companyId
string, optional
Company identifier
changeDate
string, optional
Date for latest change on signing rights for company
coverage
string, optional
The coverage of the answer, explains if all the possible signing combinations could be found. possible values: complete, partial and none
adminSign
Array, optional
Array of persons that are allowed to sign for the company only in administrative matters
combinations
Array, optional
Possible signing combinations
name
string, optional
signatory name
personalNumber
string, optional
Personal identification number for signatory
positions
Array, optional
Positions that signatory has
roleName
string, optional
role name for board position
roleCode
integer, optional
role code number for board position
anomalies
Array, optional
Potential anomalies concerning this signatory
anomalyCode
string, optional
code identifying possible anomaly
anomalyDescription
integer, optional
description for anomaly code

Anomaly codes

Code Description
1 Company identifier instead of personal identifier
2 Incomplete personal identifier

Coverage

The "coverage" field can have one of three different values explaining if the response contains all different signatory combinations or if there is anything that has not been possible to interpret.

Value Description
complete Response contains all signing combinations for the company
partial There is a possibility that there are signing combinations not included in the response.
none No signing combinations identified for requested company.

Organization Numbers for Test

Example: 5565002465

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \
'https://api.roaring.io/se/company/signing-combinations/\
1.0/combinations/5565002465'

Response

{
  "companyId": "5565002465",
  "changeDate": "2018-06-10",
  "coverage": "complete",
  "adminSign": null,
  "combinations": [
    [
      {
        "name": "Efternamn2609, Helga Viktoria",
        "positions": [
          {
            "roleCode": 5,
            "roleName": "Ledamot"
          }
        ],
        "personalNumber": "192907304766",
        "anomalies":null
      }
    ],
    [
      {
        "name": "Efternamn2401, Petra",
        "positions": [
          {
            "roleCode": 10,
            "roleName": "Suppleant"
          }
        ],
        "personalNumber": "196805029268",
        "anomalies":null
      }
    ]
  ]
}

Example: 5569030264

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \
'https://api.roaring.io/se/company/signing-combinations/\
1.0/combinations/5569030264'

Response

{
  "error": "NotFound",
  "message": "No right to sign"
}

This dev company data service fetches test company data information from a database containing a set of fictive persons with various different information types available.

Here are some personal indentity numbers available in the test data to get your testing going.

Note that this is test data. Thus, information will change over time and can disappear. These are only examples of the responses you can receive in production.

Legalform Swedish Type of test case Organizational number
Kommanditbolag Active company, includes Anomaly information 9168937861
Aktiebolag Active company, not registered for any tax, company code unknown. 5565002465
Aktiebolag Active company, registered for tax. 5567164818
Aktiebolag Active company, registered for tax. 5564866803
Aktiebolag Active company, registered for tax, head office. 5569994600
Aktiebolag Active company, merger completed. 5560572850
Aktiebolag Bankruptcy) 5569030264

Signatory

Company Board Members API contains complete information about a swedish company's all company signatories.

Is used to make sure that it is the right person you do business with and that they can sign an agreement.

Common use-cases:

Endpoint

https://api.roaring.io/se/company/signatory/1.1/

Detailed data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer site

Model Explanation
companyId
string, optional
Company identifier (company registration number / organization number)
changeDate
string, optional
Date for when the record was last changed
companySignatory
string, optional
Signatory for the company

Organization Numbers for Test

Example: 5565002465

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \
'https://api.roaring.io/se/company/signatory/1.1/5565002465'

Response

{
  "changeDate": "2016-12-10",
  "companyId": "5565002465",
  "companySignatory": "Firman tecknas av styrelsen  Firman tecknas var för sig av  >Wilson, Erik Sternhard Mattias  >Wilson, Karl Viktor Jonas"
}

This dev company data service fetches test company data information from a database containing a set of fictive persons with various different information types available.

Here are some personal indentity numbers available in the test data to get your testing going.

Note that this is test data. Thus, information will change over time and can disappear. These are only examples of the responses you can receive in production.

Legalform Swedish Type of test case Organizational number
Kommanditbolag 9168937861
Bostadsrättsförening 7696053631
Aktiebolag Active company, not registered for any tax, company code unknown. 5565002465
Aktiebolag Active company, registered for tax. 5567164818
Aktiebolag Active company, registered for tax. 5564866803
Aktiebolag Active company, registered for tax, head office. 5569994600
Aktiebolag Liquidation approved, C/O address 5590506506
Aktiebolag Active company, merger completed. 5560572850
Aktiebolag Bankruptcy 5569030264

Credit Decision

The service is used to get automated credit decisions. Important before giving loans or credit and billing.

Endpoint

https://api.roaring.io/se/company/credit-decision/1.1/{companyId}

Detailed data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer site

Model Explanation
companyId
string, optional
Company identifier
statusCode
string, optional
Company status code
statusText
string, optional
Company status text
rejections
CompanyRejection, optional
address
string, optional
Postal address street/P.O BOX.
zipCode
string, optional
Postal address zipcode
town
string, optional
Postal address town
causeOfReject
string, optional
rejectText
string, optional
rejectComment
string, optional

Responses

Hard coded denial response codes for companies. After control of the common responses the next step is to control if the company is active or not. Here the status of the company is verified. If the company is inactive (no longer a living company) the block containing code and text for the current company status will be returned. The request will not move on to validate the company against the credit template. The denial means that a company has a bankruptcy concluded, liquidation concluded, the company has been stricken off, a concluded fusion or that the company has been delisted.

Company Denial Codes

Code Description
S200 Inactive
S203 Dormant
S231 Liquidation concluded
S241 Merger concluded
S291 Bankruptcy concluded
S292 Bankruptcy concluded
S300 Delisted
S336 Company stricken off according to the Companies Act 13:18
S337 Company stricken off
S350 Stricken off according to the Partnership and Non-registered Partnership Act 17:2
S351 Stricken off according to the Economic Association (co-operative) Act 11:18
S352 Delisted
S353 Delisted due to new owner
S354 Delisted due to fusion with foreign company
S360 Delisted due to liquidation/bankruptcy of foreign company
S361 Delisted due to discontinuation of business operation
S362 Delisted, the branch office has no managing director
S363 Delisted, according to court order
S364 Delisted, annual report lacking
S370 Delisted at own request
S371 Delisted by request from Bolagsverket (Companies House) S373 Avfört Stricken off
S374 Stricken off, re-registered as a jointstock bank S377 Avregistrat pga ombildning Delisted due to conversion

Additional denial codes concerning sole proprietorship

Code Description
S2 Protected
S3 Locked
S4 Deceased
S5 Removed from register
S6 Emigrated
S7 Social security number changed

Organization Numbers for Test

Example: Approved | 5564866803

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \
'https://api.roaring.io/se/company\
/credit-decision/1.1/5564866803?template=Roaring'

Response

{
  "zipCode": "45534",
  "companyId": "5564866803",
  "rejections": [],
  "address": "Hededalsvägen 20",
  "town": "MUNKEDAL",
  "statusText": "Approved",
  "statusCode": "1"
}

Example: Trial | 7696245120

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \
'https://api.roaring.io/se/company\
/credit-decision/1.1/7696245120?template=Roaring'

Response

{
  "companyId": "7696245120",
  "rejections": [],
  "statusText": "Trial",
  "statusCode": "4"
}

Example: Not Approved | 5565002465

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \
'https://api.roaring.io/se/company\
/credit-decision/1.1/5565002465?template=Roaring'

Response

{
  "companyId": "5565002465",
  "rejections": [
    {
      "rejectComment": "",
      "causeOfReject": "9",
      "rejectText": "Wrong username or password"
    }
  ],
  "statusText": "Not Approved",
  "statusCode": "2"
}

This dev company data service fetches test company data information from a database containing a set of fictive companies with various different information types available.

Here are some company ID numbers available in the test data to get your testing going.

Note that this is test data. The information shown is per 2017-03-20. Thus, information will change over time and can disappear. These are only examples of the responses you can receive in production.

Paramters for request countryCode: se companyId: (example) 5564866803 template: (anything)

Status Reject text Organizational number
Approved 5564866803
Trial 7696245120
Not Approved Incorrect info XML code 9696373076
Not Approved No access to this product 5563260701
Not Approved Wrong username or password 5565002465
Not Approved Wrong block 5567164818
Not Approved Wrong template 5567664601
Not Approved Security validation not ok 5561289744

Here are some more test numbers in our Sandbox

Status Reject text Organizational number
Not Approved Incorrect info XML code 9696373076
Not Approved An error occurred, please try again later 9168937861
Not Approved No match record 8024045489
Not Approved Your account does not allow information access to this company 5590964275
Not Approved No access to this company type 5569979734
Not Approved No active templates found 5590672613
Not Approved Inactive 5569466856
Not Approved Dormant 717913520
Not Approved Liquidation concluded  5590506506
Not Approved Merger concluded 5560572850
Not Approved Bankruptcy concluded 5569030264
Not Approved Bankruptcy concluded 8394004322
Not Approved Delisted 5561979740
Not Approved Company stricken off according to the Companies Act 13:18 9697313006
Not Approved  Company stricken off 5561614206
Not Approved Stricken off according to the Partnership and Non-registered Partnership Act 17:2 7904182396
Not Approved Stricken off according to the Economic Association (co-operative) Act 5569015075
Not Approved Delisted 3701308888
Not Approved Delisted due to new owner 2907304766
Not Approved Delisted due to fusion with foreign company 6805029268
Not Approved Delisted due to liquidation/bankruptcy of foreign company 4812161596
Not Approved Delisted due to discontinuation of business operation 5561881607
Not Approved Delisted, the branch office has no managing director 9111029196
Not Approved Delisted, according to court order 9111022399
Not Approved Delisted, annual report lacking 5561344309
Not Approved Delisted at own request 3604139208
Not Approved Delisted by request from Bolagsverket 8512122394
Not Approved Stricken off 7911012388
Not Approved Stricken off, re-registered as a joint- stock bank 7806082397
Not Approved Delisted due to conversion 9211629192###

Event

Company Event API monitors all changes and allows you to keep your records updated with current information

Common use-cases:

Endpoint

https://api.roaring.io/se/company/event/1.0/changes

Detailed data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer site

Model Explanation
companyId
string, optional
Company identifier ,
code
string, optional
Change code for the event ,
changeDate
string, optional
Date for when the event occurred ,
dataSet
Array[string], optional
List of all Roaring datasets affected by the event

Change Codes

Change Code Beskrivning Swedish Description English API
ADRC Adress, ändrad Address, changed Overview
SHCD Aktiekapital, minskat   Share capital, reduction Economy
SHCN Aktiekapital, nybildning Share capital, new Economy
SHCI Aktiekapital, nyemission Share capital, new issue Economy
EMCC Arb. avgift, ändrad Employment tax, changed Overview
PRTN Beslutad arbetsgivaravgift inkommen, första fillfället PAYE registered, first occasion Overview
ANAN  Bokslut, nytt Annual account, new Economy
ANAC Bokslut, ändrat Annual account, changed Economy
FAXR Faxnummer, borttaget Fax number, removed Overview, Establishments
FAXN Faxnummer, nytt Fax number, new Overview, Establishments
FAXC Faxnummer, ändrat Fax number, changed Overview, Establishments
CTXC F-skatt, ändrad Company tax, changed Overview
NAMC Företagsnamn, ändrat Company name, changed Overview
ASIC Företagstecknare ändrad alternativt ny eller ändrad vakanstext Authorised signatories amended or new/amended vacancy text Signatory, Board Members
REPC Företrädaruppgifter, ändrade Company representatives, changed Signatory, Board Members
REGC Förändring av företagets registreringsdatum Date of registration, changed Overview
MERC Information om fusion, ändrad Merge information, changed Overview
VATC Moms, ändrad VAT, changed Overview
RESC Registrerat säte, ändrat Place of residence, changed Overview
STAC Status, ändrad Status, changed Overview
BOAC Styrelse, ändrad Board, changed Board Members
PHOR Telefonnummer, borttaget Phone number, removed Overview, Establishments
PHON Telefonnummer, nytt Phone number, new Overview, Establishments
PHOC Telefonnummer, ändrat Phone number, changed Overview, Establishments

Organization Numbers for Test

Request example: 556500-2465, 556999-4600

curl -X POST --header 'Content-Type: application/json' \
--header 'Accept: application/json' --header 'Authorization: Bearer {ACCESS TOKEN}' \ 
   "requests": [ \ 
     { \ 
       "companyId": "5565002465", \ 
       "date": "2018-07-11" \ 
     } \ 
   ] \ 
 } \ 
     { \ 
       "companyId": "5569994600", \ 
       "date": "2018-07-11" \ 
     } \ 
   ] \ 
 }' 'https://api.roaring.io/se/company/event/1.0/changes'

Response example:

{
  "responseInfo": {
    "requestCount": 1,
    "hitCount": 6,
    "noMatchIds": []
  },
  "responses": [
    {
      "companyId": "5565002465",
      "code": "ANAN",
      "changeDate": "20180611",
      "dataSet": [
        "company-economy-overview"
      ]
    },
    {
      "companyId": "5565002465",
      "code": "ASIC",
      "changeDate": "20180808",
      "dataSet": [
        "company-signatory",
        "company-board-members"
      ]
    },
    {
      "companyId": "5565002465",
      "code": "REPC",
      "changeDate": "20180808",
      "dataSet": [
        "company-signatory",
        "company-board-members"
      ]
    },
    {
      "companyId": "5565002465",
      "code": "REPC",
      "changeDate": "20181003",
      "dataSet": [
        "company-signatory",
        "company-board-members"
      ]
    },
    {
      "companyId": "5565002465",
      "code": "ADRC",
      "changeDate": "20180131",
      "dataSet": [
        "company-overview"
      ]
    },
    {
      "companyId": "5565002465",
      "code": "ASIC",
      "changeDate": "20181003",
      "dataSet": [
        "company-signatory",
        "company-board-members"
      ]
    }
  ]
  }

This dev company data service fetches test company data information from a database containing a set of fictive companies with various different information types available.

Here are some personal indentity numbers available in the test data to get your testing going.

Note that this is test data. Thus, information will change over time and can disappear. These are only examples of the responses you can receive in production.

Organization Number  Change Date
916893-7861  datum 2018-07-11
556500-2465  datum 2018-07-11
556057-2850  datum 2018-07-11
5565002465, 5569994600  datum 2018-07-11
5569030264  datum 2018-07-11
769605-3631 datum 2018-06-11

Norway

The SimpleSearch API is a simple feature for searching a Norwegian company using company names.

Detailed data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer portal.

Endpoint

https://api.roaring.io/no/company/simple-search/1.0

Atributes

Model Explanation
CompanySimpleSearchResult
moreHits
boolean, optional
true if there are more hits then the returned max of 20
hitCount
integer, optional
matches
Array[inline_model], optional
Array of hits on the search
inline_model
companyName
string, optional
Name of the company
legalGroupCode
string, optional
Which kind of company it is
legalGroupText
string, optional
Description of which kind of company it is
links
Array[Inline Model 1], optional
array of api-links to fetch information on the company
Inline Model 1
type
string, optional
Name of API the link points to ,
method
string, optional
API verb ,
url
string, optional
URL link to the API call for retrieving information on the company

Example response

The Simple Search service retrieves production data. This means that all companies are searchable even in the sandbox.

Search parameters for Test

Example Response | Juniors, Kongsberg

Request

curl -X GET --header 'Accept: application/json' \ 
--header 'Authorization: Bearer  {ACCESS TOKEN}' \
'https://api.roaring.io/no/company/simple-search/1.0/search?name=JUNIORS&town=KONGSBERG'

Response

{
  "moreHits": false,
  "hitCount": 2,
  "matches": [
    {
      "companyName": "JUNIORS AS",
      "legalGroupCode": "BEDR",
      "legalGroupText": "Underavdeling",
      "town": "KONGSBERG",
      "links": [
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/no/company/overview/971697555"
        }
      ]
    },
    {
      "companyName": "JUNIORS AS",
      "legalGroupCode": "AS",
      "legalGroupText": "Aksjeselskap",
      "town": "KONGSBERG",
      "links": [
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/no/company/overview/958163363"
        }
      ]
    }
  ]
}

Example Response | Metallco AS, Oslo

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer  {ACCESS TOKEN}' \
'https://api.roaring.io/no/company/simple-search/1.0/search?name=METALLCO%20AS&town=oslo'

Response

{
  "moreHits": false,
  "hitCount": 1,
  "matches": [
    {
      "companyName": "METALLCO AS",
      "legalGroupCode": "AS",
      "legalGroupText": "Aksjeselskap",
      "town": "OSLO",
      "links": [
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/no/company/overview/810392312"
        }
      ]
    }
  ]
}
Legalform Norwegian Company name Town Organizational number
Bedrift Juniors AS Kongsberg 971697555
Aksjeselskap Metallco AS Oslo 810392312

Overview

Company Overview API contains basic information about all companies in Norway.

Used for CRM, prospecting, mailing, delivery information and verification that the company is registered for tax.

Common use-cases:

Detailed data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer site

Model Explanation
companyId
string optional
Company identifier (company registration number / organization number)
changeDate
string optional
Date for when the record was last changed
statusCode
string optional
Company status code
statusTextHigh
string optional
Company status text
statusTextDetailed
string optional
Company status text detailed
statusDateFrom
string optional
Company status date from
companyName
string optional
Company name
coAddress
string optional
Postal address C/O address
address
string optional
Postal address street/P.O BOX
zipCode
string optional
Postal address zipcode
town
string optional
Postal address town
commune
string optional
Postal address commune name
county
string optional
Postal address county
visitAddress
string optional
Visiting address street name street number and unit
visitStreet
string optional
Visiting address street
visitStreetNumber
string optional
Visiting address number
visitStreetUnit
string optional
Visiting address unit
visitZipCode
string optional
Visiting address zip code
visitTown
string optional
Visiting address town
visitCommune
string optional
Visiting address commune
visitCounty
string optional
Visiting address county
phoneNumber
string optional
Telephone number
faxNumber
string optional
Fax number
email
string optional
Email address
webAddress
string optional
Web address
legalGroupCode
string optional
Company type code
legalGroupText
string optional
Company type text
preliminaryTaxReg
string optional
Company is approved for preliminary tax (F-skatt Sweden)
employerContributionReg
string optional
Company is registererd for employer contribution tax (Arb.avg Sweden)
vatReg
string optional
Company is registered for VAT (MOMS Sweden)
vepChangedDate
string optional
Show the latest date any of preliminaryTaxReg employerContributionReg or vatReg has had a change
companyRegistrationDate
string optional
Company registration date
companyDeregistrationDate
string optional
Company deregistration date
industryCode
string optional
Company main industry NACE code
industryText
string optional
Company main industry NACE text
topDirectorName
string optional
Top director's name
topDirectorFunction
string optional
Top director's function
numberCompanyUnits
string optional
Number of company units/workplaces
numberEmployees
string optional
Number of employees (pcs)

Company Status Codes

A list of available status codes for a company is find here

Organization Numbers for Test

Example: Aksjeselskap | 810059672

{
  "numberCompanyUnits": "1",
  "statusCode": "A",
  "registeredTown": "EIDSVÅG I ROMSDAL",
  "registeredZipCode": "6460",
  "phoneNumber": "71232456",
  "startDateVat": "2016-03",
  "topDirectorFunction": "Daglig leder/administrerende direktør",
  "industryText": "Utleie av egen eller leid fast eiendom ellers",
  "statusTextDetailed": "Active",
  "coAddress": null,
  "zipCode": null,
  "vatYN": "no",
  "industryTextEng": "Other letting of real estate",
  "county": null,
  "industryCode": "68.209",
  "registeredCommuneCode": "1543",
  "communeCode": null,
  "statusTextHigh": "Active",
  "changeDate": "2017-10-14",
  "companyName": "AASEN & FARSTAD AS",
  "statusDateFrom": null,
  "vatReg": "0",
  "legalGroupCode": "AS",
  "address": null,
  "legalGroupTextEng": "Limited company",
  "registeredCommune": "Nesset",
  "commune": null,
  "companyRegistrationDate": "19950219",
  "town": null,
  "registeredCoAddress": null,
  "companyId": "810059672",
  "topDirectorName": "Farstad, Svein Olav",
  "legalGroupText": "Aksjeselskap",
  "registeredAddress": "Nedre Liedgardsveg 2",
  "companyDeregistrationDate": null,
  "faxNumber": "71232654"
}

This dev company data service fetches test company data information from a database containing a set of fictive companies with various different information types available.

Here are some company ID numbers available in the test data to get your testing going.

Note that this is test data. The information shown is per 2017-03-20. Thus, information will change over time and can disappear. These are only examples of the responses you can receive in production.

Legalform Norwegian Organizational number
Underavdeling 971697555
Enkeltpersonsforetak 919434104
Aksjeselskap 810059672
Aksjeselskap 810392312
Kirkelig Fellesråd 987569166
Administrativ Enhet Offentlig Sektor 990492263
Selskap Med Begrenset Ansvar 970232222
Forening/Lag/Innretning 811556912
Annet Foretak Iflg. Særsk. Lov 818711832

Signing Combination

Company Signing Combinations API is used to get automate confirmation of which compositions of people that are allowed to sign for the company.

Common use-cases:

Endpoint

https://api.roaring.io/no/company/signing-combinations/1.0

Detailed data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer site

Model Explanation
companyId
string, optional
Company identifier
changeDate
string, optional
Date for latest change on signing rights for company
coverage
string, optional
The coverage of the answer, explains if all the possible signing combinations could be found. possible values: complete, partial and none
adminSign
Array[CompanySigningCombinationPerson], optional
Contains persons that are allowed to sign for the company only in administrative matters
combinations
Array[Inline Model 1], optional
Possible signing combinations
prokura
Array[Inline Model 2], optional
Possible prokura signing combinations
name
string, optional
Signatory name
personalNumber (string, optional Personal identification number for signatory
positions
Array[Inline Model 3], optional
Positions that signatory holds
anomalies
Array[Inline Model 4], optional
Potential anomalies concerning this signatory
roleName
string, optional
role name for board position
roleCode
string, optional
role code number for board position
anomalyCode
integer, optional
code identifying possible anomaly
anomalyDescription
string, optional
description for anomaly code

Anomaly codes

Code Description
1 Company identifier instead of personal identifier
2 Incomplete personal identifier

Coverage

The "coverage" field can have one of three different values explaining if the response contains all different signatory combinations or if there is anything that has not been possible to interpret.

Value Description
complete Response contains all signing combinations for the company
partial There is a possibility that there are signing combinations not included in the response.
none No signing combinations identified for requested company.

Organization Numbers for Test

Example: 810059672

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \
'https://api.roaring.io/no/company/signing-combinations/1.0/\
combinations/810059672'

Response

{
  "companyId": "810059672",
  "changeDate": "2018-10-12",
  "coverage": "Complete",
  "combinations": [
    [
      {
        "name": "Bror Johansen",
        "positions": [
          {
            "roleCode": "DAGL",
            "roleName": "Daglig leder/administrerende direktør"
          },
          {
            "roleCode": "LEDE",
            "roleName": "Styreleder"
          }
        ],
        "personalNumber": "31120000767",
        "anomalies": null
      }
    ]
  ],
  "prokura": []
}

This dev company data service fetches test company data information from a database containing a set of fictive persons with various different information types available.

Here are some personal indentity numbers available in the test data to get your testing going.

Note that this is test data. Thus, information will change over time and can disappear. These are only examples of the responses you can receive in production.

Legalform Norwegian Organizational number
Underavdeling 971697555
Enkeltpersonsforetak 919434104
Aksjeselskap 810059672
Aksjeselskap 810392312
Kirkelig Fellesråd  987569166
Annet Foretak Iflg. Særsk. Lov 818711832

Miscellaneous

Global

Sanctions Lists

Control if a person or organisation is on the EU or UN sanction lists and financial connection is prohibited.

Common use-cases:

Endpoint

https://api.roaring.io/global/sanctions-lists/1.0

Detailed data description

Detailed description of all the retrievable data in the API Object Model. The API Object model is also visible in the presentation of each API on the developer site

Model Explanation
SanctionResult
hitCount
integer, optional
Amount of returned entities
hits
Array[inline_model], optional
Array of search hits
inline_model
entityType
string, optional
Categorising entity as person or organisation
sanctionOrganisation
string, optional
Organisation that owns the sancion decision
gender
string, optional
Sanction entity gender
legalBasis
string, optional
Legal basis for being on the sanction list
pdfLink
string, optional
Link to the PDF version of the sanction report
programme
string, optional
Sanction program under which the entity is placed
remark
string, optional
Eventual remark on the entity
versionNumber
string, optional
Entity version (changes on entity update)
unListType
string, optional
referenceNumber
string, optional
Sanction organisation reference number
comment
string, optional
Comment placed by the sanction organisation
listedDate
string, optional
names
Array[SanctionName], optional
Array of names associated with the sanction entity
aliases
Array[SanctionAlias], optional
Array of aliases associated with the
sanction
entity
addresses
Array[SanctionAddress], optional
Array of addresses associated with the sanction entity
birthDataItems
Array[SanctionBirthDataItem], optional
Array of birth data associated with the sanction entity
citizenDataItems
Array[SanctionCitizenDataItem], optional
Array of citizen data associated with the sanction entity
entityNationality
Array[SanctionNationality], optional
Array of nationality data associated with the sanction entity
entityDesignations
Array[SanctionDesignation], optional
Array of designation data associated with the sanction entity
updateHistoryItems
Array[SanctionUpdateHistoryItem], optional
Array of historical updates associated with the sanction entity
documentations
Array[SanctionDocument], optional
Array of documents associated with the sanction entity
SanctionName
firstName
string, optional
secondName
string, optional
lastName
string, optional
wholeName
string, optional
thirdName
string, optional
fourthName
string, optional
originalScriptName
string, optional
title
string, optional
legalBasis
string, optional
pdfLink
string, optional
programme
string, optional
remark
string, optional
listedDate
string, optional
language
string, optional
SanctionAlias
name
string, optional
quality
string, optional
dateOfBirth
string, optional
cityOfBirth
string, optional
countryOfBirth
string, optional
note
string, optional
SanctionAddress
street
string, optional
number
string, optional
zipcode
string, optional
city
string, optional
stateProvince
string, optional
country
string, optional
other
string, optional
legalBasis
string, optional
pdfLink
string, optional
programme
string, optional
remark
string, optional
listedDate
string, optional
SanctionBirthDataItem
date
string, optional
year
string, optional
fromYear
string, optional
toYear
string, optional
place
string, optional
city
string, optional
stateProvince
string, optional
country
string, optional
typeOfDate
string, optional
noteDate
string, optional
notePlace
string, optional
legalBasis
string, optional
pdfLink
string, optional
programme
string, optional
remark
string, optional
listedDate
string, optional
SanctionCitizenDataItem
country
string, optional
legalBasis
string, optional
pdfLink
string, optional
programme
string, optional
remark
string, optional
listedDate
string, optional
SanctionNationality
nationality
string, optional
SanctionDesignation
designation string, optional
SanctionUpdateHistoryItem
updatedDate
string, optional
updatedItem
string, optional
SanctionDocument
passportId
string, optional
number
string, optional
issuingCountry
string, optional
typeOfDocument
string, optional
typeOfDocument2
string, optional
dateOfIssue
string, optional
cityOfIssue
string, optional
countryOfIssue
string, optional
legalBasis
string, optional
pdfLink
string, optional
programme
string, optional
remark
string, optional
listedDate
string, optional

Programme codes

Code Programme name
Afg Afghanistan
Bdi Burundi
Blr Belarus
Caf Central african republic
Chem Chemical weapons
Civ Ivory coast
Cod Emocratic republic of congo
Com Comoros
Code Programmes
Egy Egypt
Eri Eritrea
Euaq European autonomous al-qaeda
Gin Guinea
Gnb Guinea-bissau
Hti Haiti
Icty Persons indicted by international criminal court
Irn Iran
Irq Iraq - former president saddam hussein
Lbn Lebanon - suspects assassination
Lbr Liberia - former president taylor
Lby Libya
Mmr Myanmar/burma
Prk Democratic people´s republic of korea
Rus Russia
Sdn Sudan
Som Somalia
Ssd South sudan
Syr Syrian arab republic
Taqa Al qaeda
Terr Terrorist groups (foreign terrorists)
Tun Tunisia
Ukr Ukraine
Unli United nations listing of sanctioned individuals and entities
Ven Venezuela
Yem Yemen
Yug Yugoslavia (serbia and montenegro)
Zwe Zimbabwe

Objects for Test

Example

Request

curl -X GET --header 'Accept: application/json' --header 'Authorization: Bearer {ACCESS TOKEN}' \ 
'https://api.roaring.io/global/sanctions-lists/1.0/search?name=Leo%20Efternamn2636'

Response

{
  "hitCount": 1,
  "hits": [
    {
      "entityType": "Person",
      "sanctionOrganisation": "EU",
      "gender": "Male",
      "legalBasis": "596/2013 (OJ L172)",
      "pdfLink": "http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2013:172:0001:0003:EN:PDF",
      "programme": "TAQA",
      "names": [
        {
          "firstName": "Leo",
          "secondName": "Muhammed Awad",
          "lastName": "Efternamn2636",
          "wholeName": "Leo Efternamn2636",
          "title": "Shaykh",
          "legalBasis": "844/2007 (OJ L186)",
          "pdfLink": "http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2007:186:0024:0028:EN:PDF",
          "programme": "TAQA",
          "listedDate": "2007-07-18"
        },
        {
          "wholeName": "Leo Efternamn2636",
          "legalBasis": "844/2007 (OJ L186)",
          "pdfLink": "http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2007:186:0024:0028:EN:PDF",
          "programme": "TAQA",
          "listedDate": "2007-07-18"
        }
      ],
      "birthDataItems": [
        {
          "date": "1957-03-10",
          "country": "YEM",
          "legalBasis": "844/2007 (OJ L186)",
          "pdfLink": "http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=OJ:L:2007:186:0024:0028:EN:PDF",
          "programme": "TAQA",
          "listedDate": "2007-07-18"
        }
      ],
      "updateHistoryItems": [
        {
          "updatedDate": "2018-06-20T04:00:13.353",
          "updatedItem": "Entity"
        },
        {
          "updatedDate": "2018-06-20T04:00:13.353",
          "updatedItem": "Name"
        }
      ]
    }
  ]
}

Request

curl -X GET --header 'Accept: application/json' --header 'Authorization: Bearer {ACCESS TOKEN}' \ 
'https://api.roaring.io/global/sanctions-lists/1.0/search?name=The%20Group%20for%20the%20Preservation%20of%20Vegetables'

Response

{
  "hitCount": 1,
  "hits": [
    {
      "entityType": "Organisation",
      "sanctionOrganisation": "FN",
      "gender": "Unknown",
      "versionNumber": 1,
      "unListType": "El-Baba",
      "referenceNumber": "QDe.004",
      "comment": "Review pursuant to Security Council resolution 1822 (2008) was concluded on 21 Jun. 2010. INTERPOL-UN Security Council Special Notice web link: https://www.interpol.int/en/notice/search/une/5278330",
      "listedDate": {
        "year": 2001,
        "month": 10,
        "day": 6
      },
      "names": [
        {
          "firstName": "EL-BABA",
          "listedDate": "2001-10-06"
        }
      ],
      "aliases": [
        {
          "name": "Chock",
          "quality": "a.k.a."
        },
        {
          "name": "Al Radience",
          "quality": "a.k.a."
        },
        {
          "name": "Organic explanation",
          "quality": "a.k.a."
        },
        {
          "name": "The Group for the Preservation of Vegetables",
          "quality": "a.k.a."
        },
        {
          "name": "The Organic Army for the Liberation of Vegetables",
          "quality": "a.k.a."
        },
        {
          "name": "El Raidababa",
          "quality": "a.k.a."
        }
      ],
      "updateHistoryItems": [
        {
          "updatedDate": "2018-06-18T13:19:11.627"
        },
        {
          "updatedDate": "2018-06-18T13:19:11.627"
        },
        {
          "updatedDate": "2018-06-18T13:19:11.627",
          "updatedItem": "Entity"
        }
      ]
    }
  ]
}

This dev company data service fetches test company data information from a database containing a set of fictive persons with various different information types available.

Here are some personal indentity numbers available in the test data to get your testing going.

Note that this is test data. Thus, information will change over time and can disappear. These are only examples of the responses you can receive in production.

Type of test case Search criteria
Person Leo Efternamn2636
Organisation The Group for the Preservation of Vegetables