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 the API you want to you use.
  4. Now you need to subscribe to the API.

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 permit. You need to fill and sign 3 forms,

  1. SPAR ansökan (SPAR application)
  2. Kontaktuppgifter (Contact details)
  3. Biträdesavtal(Assistance agreement). You will find the forms here

When you have filled the forms and signed them you shall scan them and send them to support@roaring.io Roaring will check the forms and finish the application for you. Once you receive the permit you will be informed and then you are ready to use Person API production data. The application 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.

SE | Person API

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

Endpoint

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

Detailed Person 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
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"
          }
        ]
      }
    }
  ]
}

Example: National Registration Address | 192907304766

Request

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

Response

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2010-02-02T00:00",
      "personalNumber": "192907304766",
      "hasHistory": true,
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2010-02-02T00:00",
          "dateTo": "9999-12-31T00:00",
          "firstName": "Helga Viktoria",
          "surName": "Efternamn2609",
          "gender": "F",
          "birthDate": "1929-07-30T00:00"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2015-12-18T00:00",
            "dateTo": "9999-12-31T00:00",
            "registrationDate": "2000-11-01T00:00",
            "careOf": "CO-NAMN",
            "deliveryAddress1": "HÖGER HUS",
            "deliveryAddress2": "Gatan218 3, ANDRA HUSET PÅ",
            "postalNumber": "11140",
            "city": "STOCKHOLM",
            "districtCode": "215020",
            "communeCode": "80",
            "countyCode": "01"
          }
        ]
      }
    }
  ]
}

Example: Special Post Address | 196805029268

Request

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

Response

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2010-02-02T00:00",
      "personalNumber": "196805029268",
      "hasHistory": true,
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2010-02-02T00:00",
          "dateTo": "9999-12-31T00:00",
          "firstName": "Petra",
          "surName": "Efternamn2401",
          "gender": "F",
          "birthDate": "1968-05-02T00:00"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2015-12-18T00:00",
            "dateTo": "9999-12-31T00:00",
            "registrationDate": "1986-10-01T00:00",
            "deliveryAddress2": "Gatan140 11",
            "postalNumber": "98131",
            "city": "KIRUNA",
            "districtCode": "324024",
            "communeCode": "84",
            "countyCode": "25"
          }
        ],
        "specialPostAddress": [
          {
            "dateFrom": "2015-12-18T00:00",
            "dateTo": "9999-12-31T00:00",
            "careOf": "CO-NAMN",
            "deliveryAddress1": "HÖGER HUS",
            "deliveryAddress2": "Gatan170 2 25 TR LÄG 16",
            "postalNumber": "11138",
            "city": "STOCKHOLM"
          }
        ]
      }
    }
  ]
}

Foreign Address | 194812161596

Request

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

Response

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2010-02-02T00:00",
      "personalNumber": "194812161596",
      "hasHistory": true,
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2010-02-02T00:00",
          "dateTo": "9999-12-31T00:00",
          "firstName": "Nils Uno",
          "surName": "Efternamn1433",
          "gender": "M",
          "birthDate": "1948-12-16T00:00"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2015-12-18T00:00",
            "dateTo": "9999-12-31T00:00",
            "registrationDate": "1948-12-16T00:00",
            "deliveryAddress2": "Gatan267 2",
            "postalNumber": "96191",
            "city": "BODEN",
            "districtCode": "325010",
            "communeCode": "82",
            "countyCode": "25"
          }
        ],
        "foreignAddress": [
          {
            "dateFrom": "2015-12-18T00:00",
            "dateTo": "9999-12-31T00:00",
            "deliveryAddress1": "UTLANDSGATAN 111",
            "deliveryAddress2": "UTLANDOMRÅDE",
            "deliveryAddress3": "STADEN",
            "country": "NORGE"
          }
        ]
      }
    }
  ]
}

Example: History | 197904182396

Request

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

Response

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2010-02-15T00:00",
      "personalNumber": "197904182396",
      "hasHistory": true,
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2010-02-15T00:00",
          "dateTo": "9999-12-31T00:00",
          "firstName": "Kuno",
          "givenName": 10,
          "surName": "Efternamn2993",
          "gender": "M",
          "birthDate": "1979-04-18T00:00"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2015-12-18T00:00",
            "dateTo": "9999-12-31T00:00",
            "registrationDate": "2011-02-04T00:00",
            "deliveryAddress2": "Gatan225 13",
            "postalNumber": "13131",
            "city": "NACKA",
            "districtCode": "212104",
            "communeCode": "82",
            "countyCode": "01"
          }
        ]
      }
    }
  ]
}

Example: Personal Number Changed From | 199111029196

Request

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

Response

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2011-05-06T00:00",
      "personalNumber": "199111029196",
      "hasHistory": true,
      "secrecyChangeDate": "2011-05-06T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2011-05-06T00:00",
          "dateTo": "9999-12-31T00:00",
          "firstName": "Martin Oskar",
          "surName": "Efternamn3227",
          "gender": "M",
          "birthDate": "1991-11-02T00:00",
          "personalNumberChangedFrom": "199111022399"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2015-12-18T00:00",
            "dateTo": "9999-12-31T00:00",
            "registrationDate": "1991-11-02T00:00",
            "deliveryAddress2": "Gatan330 3",
            "postalNumber": "98134",
            "city": "KIRUNA",
            "districtCode": "324023",
            "communeCode": "84",
            "countyCode": "25"
          }
        ]
      }
    }
  ]
}

Example: Personal Number Changed To | 199111022399

Request

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

Response

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2011-05-02T00:00",
      "personalNumber": "199111022399",
      "hasHistory": true,
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2011-05-02T00:00",
          "dateTo": "9999-12-31T00:00",
          "gender": "M",
          "birthDate": "1991-11-02T00:00",
          "deRegistrationReason": "G",
          "personalNumberChangedTo": "199111029196"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2011-05-02T00:00",
            "dateTo": "9999-12-31T00:00"
          }
        ]
      }
    }
  ]
}

Example: Reason for deregestering from the national registry, represented as a code G | 199111022399

Request

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

Response

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2011-05-02T00:00",
      "personalNumber": "199111022399",
      "hasHistory": true,
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2011-05-02T00:00",
          "dateTo": "9999-12-31T00:00",
          "gender": "M",
          "birthDate": "1991-11-02T00:00",
          "deRegistrationReason": "G",
          "personalNumberChangedTo": "199111029196"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2011-05-02T00:00",
            "dateTo": "9999-12-31T00:00"
          }
        ]
      }
    }
  ]
}

Example: Reason for deregestering from the national registry, represented as a code A | 193604139208

Request

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

Response

{
  "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"
          }
        ]
      }
    }
  ]
}

Example: Reason for deregestering from the national registry, represented as a code O | 198512122394

Request

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

Response

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2010-02-02T00:00",
      "personalNumber": "198512122394",
      "hasHistory": true,
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2010-02-02T00:00",
          "dateTo": "9999-12-31T00:00",
          "firstName": "Ludvig",
          "surName": "Efternamn1179",
          "gender": "M",
          "birthDate": "1985-12-12T00:00",
          "deRegistrationDate": "2010-02-02",
          "deRegistrationReason": "O"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2015-12-18T00:00",
            "dateTo": "9999-12-31T00:00",
            "registrationDate": "1999-05-03T00:00",
            "deliveryAddress2": "Gatan111 2",
            "postalNumber": "17838",
            "city": "EKERÖ",
            "districtCode": "215002",
            "communeCode": "25",
            "countyCode": "01"
          }
        ]
      }
    }
  ]
}

Example: Person is secrecy marked | 193103249078

Request

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

Response

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2017-02-28T00:00",
      "personalNumber": "197911012388",
      "hasHistory": false,
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": true,
      "details": [],
      "address": {}
    }
  ]
}

Example: Incorrect personal number | 19360413920

Request

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

Response

{
  "error": "InvalidPersonalNumber",
  "message": "The given personal number is not valid"
}

Example: Child with relational data | 200902102383

Request

curl -X GET --header 'Accept: application/json' --header 'Authorization: Bearer 31561cf3-204e-31b1-b044-5b306e923587' 'https://api.roaring.io/person/1.0/person?personalNumber=200902102383'

Response

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2010-02-02T00:00",
      "personalNumber": "200902102383",
      "hasHistory": true,
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2010-02-02T00:00",
          "dateTo": "9999-12-31T00:00",
          "surName": "Efternamn2956",
          "gender": "F",
          "birthDate": "2009-02-10T00:00"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2015-12-18T00:00",
            "dateTo": "9999-12-31T00:00",
            "registrationDate": "2009-02-10T00:00",
            "deliveryAddress2": "Gatan373 2",
            "postalNumber": "98129",
            "city": "KIRUNA",
            "districtCode": "324024",
            "communeCode": "84",
            "countyCode": "25"
          }
        ]
      },
      "relation": [
        {
          "dateFrom": "2009-02-11T00:00",
          "dateTo": "9999-12-31T00:00",
          "birthDate": "1979-04-18T00:00",
          "personalNumber": "197904182396",
          "firstName": "Kuno",
          "surName": "Efternamn2993",
          "relationType": "V"
        }
      ]
    }
  ]
}

Example: No hit in SPAR

Response

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

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 Social security number
Notification name 193701308888
National Registration Address 192907304766
Special Post Address 196805029268
Foreign Address 194812161596
History 197904182396
Personal Number Changed From 199111029196
Personal Number Changed To 199111022399
Reason for deregestering from the national registry, represented as a code G 199111022399
Reason for deregestering from the national registry, represented as a code A 193604139208
Reason for deregestering from the national registry, represented as a code O 198512122394
Person is secrecy marked 193103249078
Incorrect personal number 19360413920
Child with relational data  200902102383
No hit in SPAR

SE | Person History API

Contains historical information about all persons registered in Sweden.

Endpoint

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

Detailed Person API data description

A detailed description of all the retrievable data in the API Object Model can be find under SE | Person API.

Personal Numbers for Test

Example: Notification name | 193701308888

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2010-02-02T00:00",
      "personalNumber": "193701308888",
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2015-12-18T00:00",
            "registrationDate": "2003-01-01T00:00",
            "deliveryAddress2": "Gatan142 8",
            "postalNumber": "11146",
            "city": "STOCKHOLM",
            "congregationCode": "04",
            "communeCode": "80",
            "countyCode": "01"
          }
        ]
      }
    }
  ]
}

Example: National Registration Address | 192907304766

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2010-02-02T00:00",
      "personalNumber": "192907304766",
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2015-12-18T00:00",
            "registrationDate": "2000-11-01T00:00",
            "careOf": "CO-NAMN",
            "deliveryAddress1": "HÖGER HUS",
            "deliveryAddress2": "Gatan218 3, ANDRA HUSET PÅ",
            "postalNumber": "11140",
            "city": "STOCKHOLM",
            "congregationCode": "01",
            "communeCode": "80",
            "countyCode": "01"
          }
        ]
      }
    }
  ]
}

Example: Special Post Address | 196805029268

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2010-02-02T00:00",
      "personalNumber": "196805029268",
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2015-12-18T00:00",
            "registrationDate": "1986-10-01T00:00",
            "deliveryAddress2": "Gatan140 11",
            "postalNumber": "98131",
            "city": "KIRUNA",
            "congregationCode": "01",
            "communeCode": "84",
            "countyCode": "25"
          }
        ],
        "specialPostAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2015-12-18T00:00",
            "careOf": "CO-NAMN",
            "deliveryAddress1": "HÖGER HUS",
            "deliveryAddress2": "Gatan170 2 25 TR LÄG 16",
            "postalNumber": "11138",
            "city": "STOCKHOLM"
          }
        ]
      }
    }
  ]
}

Foreign Address | 194812161596

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2010-02-02T00:00",
      "personalNumber": "194812161596",
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2015-12-18T00:00",
            "registrationDate": "1948-12-16T00:00",
            "deliveryAddress2": "Gatan267 2",
            "postalNumber": "96191",
            "city": "BODEN",
            "congregationCode": "01",
            "communeCode": "82",
            "countyCode": "25"
          }
        ],
        "foreignAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2015-12-18T00:00",
            "deliveryAddress1": "UTLANDSGATAN 111",
            "deliveryAddress2": "UTLANDOMRÅDE",
            "deliveryAddress3": "STADEN",
            "country": "NORGE"
          }
        ]
      }
    }
  ]
}

Example: History | 197904182396

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2010-02-15T00:00",
      "personalNumber": "197904182396",
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2010-02-02T00:00",
          "dateTo": "2010-02-15T00:00",
          "firstName": "Kuno",
          "givenName": 10,
          "surName": "Efternamn1083",
          "gender": "M",
          "birthDate": "1979-04-18T00:00"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2010-02-15T00:00",
            "registrationDate": "2007-07-04T00:00",
            "deliveryAddress2": "Gatan401 2",
            "postalNumber": "13131",
            "city": "NACKA",
            "congregationCode": "01",
            "communeCode": "82",
            "countyCode": "01"
          },
          {
            "dateFrom": "2010-02-15T00:00",
            "dateTo": "2015-12-18T00:00",
            "registrationDate": "2011-02-04T00:00",
            "deliveryAddress2": "Gatan225 13",
            "postalNumber": "13131",
            "city": "NACKA",
            "congregationCode": "01",
            "communeCode": "82",
            "countyCode": "01"
          }
        ]
      }
    }
  ]
}

Example: Personal Number Changed From | 199111029196

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2011-05-06T00:00",
      "personalNumber": "199111029196",
      "secrecyChangeDate": "2011-05-06T00:00",
      "secrecyMarked": false,
      "details": [],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2011-05-06T00:00",
            "dateTo": "2015-12-18T00:00",
            "registrationDate": "1991-11-02T00:00",
            "deliveryAddress2": "Gatan330 3",
            "postalNumber": "98134",
            "city": "KIRUNA",
            "congregationCode": "02",
            "communeCode": "84",
            "countyCode": "25"
          }
        ]
      }
    }
  ]
}

Example: Personal Number Changed To | 199111022399

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2011-05-02T00:00",
      "personalNumber": "199111022399",
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2010-02-02T00:00",
          "dateTo": "2011-05-02T00:00",
          "firstName": "Martin Oskar",
          "surName": "Efternamn3227",
          "gender": "M",
          "birthDate": "1991-11-02T00:00"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2011-05-02T00:00",
            "registrationDate": "1991-11-02T00:00",
            "deliveryAddress2": "Gatan330 3",
            "postalNumber": "98134",
            "city": "KIRUNA",
            "congregationCode": "02",
            "communeCode": "84",
            "countyCode": "25"
          }
        ]
      }
    }
  ]
}

Example: Reason for deregestering from the national registry, represented as a code G | 199111022399

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2011-05-02T00:00",
      "personalNumber": "199111022399",
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2010-02-02T00:00",
          "dateTo": "2011-05-02T00:00",
          "firstName": "Martin Oskar",
          "surName": "Efternamn3227",
          "gender": "M",
          "birthDate": "1991-11-02T00:00"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2011-05-02T00:00",
            "registrationDate": "1991-11-02T00:00",
            "deliveryAddress2": "Gatan330 3",
            "postalNumber": "98134",
            "city": "KIRUNA",
            "congregationCode": "02",
            "communeCode": "84",
            "countyCode": "25"
          }
        ]
      }
    }
  ]

Example: Reason for deregestering from the national registry, represented as a code A | 193604139208

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2011-03-15T00:00",
      "personalNumber": "193604139208",
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2010-02-02T00:00",
          "dateTo": "2011-03-15T00:00",
          "firstName": "Carina",
          "surName": "Efternamn1301",
          "gender": "F",
          "birthDate": "1936-04-13T00:00"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2015-12-18T00:00",
            "registrationDate": "2002-09-01T00:00",
            "careOf": "CO-NAMN",
            "deliveryAddress2": "Gatan177 2",
            "postalNumber": "17890",
            "city": "EKERÖ",
            "congregationCode": "04",
            "communeCode": "25",
            "countyCode": "01"
          }
        ]
      }
    }
  ]
}

Example: Reason for deregestering from the national registry, represented as a code O | 198512122394

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2010-02-02T00:00",
      "personalNumber": "198512122394",
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2015-12-18T00:00",
            "registrationDate": "1999-05-03T00:00",
            "deliveryAddress2": "Gatan111 2",
            "postalNumber": "17838",
            "city": "EKERÖ",
            "congregationCode": "04",
            "communeCode": "25",
            "countyCode": "01"
          }
        ]
      }
    }
  ]
}

Example: Person is secrecy marked | 193103249078

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2017-02-28T00:00",
      "personalNumber": "197911012388",
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": true,
      "details": [],
      "address": {}
    }
  ]
}

Example: Incorrect personal number | 19360413920

{
  "error": "InvalidPersonalNumber",
  "message": "The given personal number is not valid"
}

Example: Physical person ID as a coordination number | 199211629192

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2011-05-06T00:00",
      "personalNumber": "199211629192",
      "secrecyChangeDate": "2011-05-06T00:00",
      "secrecyMarked": false,
      "details": [],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2011-05-06T00:00",
            "dateTo": "2015-12-18T00:00",
            "registrationDate": "1992-11-02T00:00",
            "deliveryAddress2": "Gatan330 8",
            "postalNumber": "98134",
            "city": "KIRUNA",
            "congregationCode": "02",
            "communeCode": "84",
            "countyCode": "25"
          }
        ]
      }
    }
  ]
}

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 Social security number
Notification name 193701308888
National Registration Address 192907304766
Special Post Address 196805029268
Foreign Address 194812161596
History 197904182396
Personal Number Changed From 199111029196
Personal Number Changed To 199111022399
Reason for deregestering from the national registry, represented as a code G 199111022399
Reason for deregestering from the national registry, represented as a code A 193604139208
Reason for deregestering from the national registry, represented as a code O 198512122394
Person is secrecy marked 193103249078
Incorrect personal number 19360413920
Physical person ID as a coordination number 199211629192

SE | Person Full API

Contains both current and historical information about all persons registered in Sweden.

Endpoint

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

Detailed Person API data description

A detailed description of all the retrievable data in the API Object Model can be find under SE | Person API.

Personal Numbers for Test

Example: Notification name | 193701308888

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2010-02-02T00:00",
      "personalNumber": "193701308888",
      "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": "2010-02-02T00:00",
            "dateTo": "2015-12-18T00:00",
            "registrationDate": "2003-01-01T00:00",
            "deliveryAddress2": "Gatan142 8",
            "postalNumber": "11146",
            "city": "STOCKHOLM",
            "congregationCode": "04",
            "communeCode": "80",
            "countyCode": "01"
          },
          {
            "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"
          }
        ]
      }
    }
  ]
}

Example: National Registration Address | 192907304766

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2010-02-02T00:00",
      "personalNumber": "192907304766",
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2010-02-02T00:00",
          "dateTo": "9999-12-31T00:00",
          "firstName": "Helga Viktoria",
          "surName": "Efternamn2609",
          "gender": "F",
          "birthDate": "1929-07-30T00:00"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2015-12-18T00:00",
            "registrationDate": "2000-11-01T00:00",
            "careOf": "CO-NAMN",
            "deliveryAddress1": "HÖGER HUS",
            "deliveryAddress2": "Gatan218 3, ANDRA HUSET PÅ",
            "postalNumber": "11140",
            "city": "STOCKHOLM",
            "congregationCode": "01",
            "communeCode": "80",
            "countyCode": "01"
          },
          {
            "dateFrom": "2015-12-18T00:00",
            "dateTo": "9999-12-31T00:00",
            "registrationDate": "2000-11-01T00:00",
            "careOf": "CO-NAMN",
            "deliveryAddress1": "HÖGER HUS",
            "deliveryAddress2": "Gatan218 3, ANDRA HUSET PÅ",
            "postalNumber": "11140",
            "city": "STOCKHOLM",
            "districtCode": "215020",
            "communeCode": "80",
            "countyCode": "01"
          }
        ]
      }
    }
  ]
}

Example: Special Post Address | 196805029268

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2010-02-02T00:00",
      "personalNumber": "196805029268",
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2010-02-02T00:00",
          "dateTo": "9999-12-31T00:00",
          "firstName": "Petra",
          "surName": "Efternamn2401",
          "gender": "F",
          "birthDate": "1968-05-02T00:00"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2015-12-18T00:00",
            "registrationDate": "1986-10-01T00:00",
            "deliveryAddress2": "Gatan140 11",
            "postalNumber": "98131",
            "city": "KIRUNA",
            "congregationCode": "01",
            "communeCode": "84",
            "countyCode": "25"
          },
          {
            "dateFrom": "2015-12-18T00:00",
            "dateTo": "9999-12-31T00:00",
            "registrationDate": "1986-10-01T00:00",
            "deliveryAddress2": "Gatan140 11",
            "postalNumber": "98131",
            "city": "KIRUNA",
            "districtCode": "324024",
            "communeCode": "84",
            "countyCode": "25"
          }
        ],
        "specialPostAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2015-12-18T00:00",
            "careOf": "CO-NAMN",
            "deliveryAddress1": "HÖGER HUS",
            "deliveryAddress2": "Gatan170 2 25 TR LÄG 16",
            "postalNumber": "11138",
            "city": "STOCKHOLM"
          },
          {
            "dateFrom": "2015-12-18T00:00",
            "dateTo": "9999-12-31T00:00",
            "careOf": "CO-NAMN",
            "deliveryAddress1": "HÖGER HUS",
            "deliveryAddress2": "Gatan170 2 25 TR LÄG 16",
            "postalNumber": "11138",
            "city": "STOCKHOLM"
          }
        ]
      }
    }
  ]
}

Foreign Address | 194812161596

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2010-02-02T00:00",
      "personalNumber": "194812161596",
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2010-02-02T00:00",
          "dateTo": "9999-12-31T00:00",
          "firstName": "Nils Uno",
          "surName": "Efternamn1433",
          "gender": "M",
          "birthDate": "1948-12-16T00:00"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2015-12-18T00:00",
            "registrationDate": "1948-12-16T00:00",
            "deliveryAddress2": "Gatan267 2",
            "postalNumber": "96191",
            "city": "BODEN",
            "congregationCode": "01",
            "communeCode": "82",
            "countyCode": "25"
          },
          {
            "dateFrom": "2015-12-18T00:00",
            "dateTo": "9999-12-31T00:00",
            "registrationDate": "1948-12-16T00:00",
            "deliveryAddress2": "Gatan267 2",
            "postalNumber": "96191",
            "city": "BODEN",
            "districtCode": "325010",
            "communeCode": "82",
            "countyCode": "25"
          }
        ],
        "foreignAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2015-12-18T00:00",
            "deliveryAddress1": "UTLANDSGATAN 111",
            "deliveryAddress2": "UTLANDOMRÅDE",
            "deliveryAddress3": "STADEN",
            "country": "NORGE"
          },
          {
            "dateFrom": "2015-12-18T00:00",
            "dateTo": "9999-12-31T00:00",
            "deliveryAddress1": "UTLANDSGATAN 111",
            "deliveryAddress2": "UTLANDOMRÅDE",
            "deliveryAddress3": "STADEN",
            "country": "NORGE"
          }
        ]
      }
    }
  ]
}

Example: History | 197904182396

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2010-02-15T00:00",
      "personalNumber": "197904182396",
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2010-02-02T00:00",
          "dateTo": "2010-02-15T00:00",
          "firstName": "Kuno",
          "givenName": 10,
          "surName": "Efternamn1083",
          "gender": "M",
          "birthDate": "1979-04-18T00:00"
        },
        {
          "dateFrom": "2010-02-15T00:00",
          "dateTo": "9999-12-31T00:00",
          "firstName": "Kuno",
          "givenName": 10,
          "surName": "Efternamn2993",
          "gender": "M",
          "birthDate": "1979-04-18T00:00"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2010-02-15T00:00",
            "registrationDate": "2007-07-04T00:00",
            "deliveryAddress2": "Gatan401 2",
            "postalNumber": "13131",
            "city": "NACKA",
            "congregationCode": "01",
            "communeCode": "82",
            "countyCode": "01"
          },
          {
            "dateFrom": "2010-02-15T00:00",
            "dateTo": "2015-12-18T00:00",
            "registrationDate": "2011-02-04T00:00",
            "deliveryAddress2": "Gatan225 13",
            "postalNumber": "13131",
            "city": "NACKA",
            "congregationCode": "01",
            "communeCode": "82",
            "countyCode": "01"
          },
          {
            "dateFrom": "2015-12-18T00:00",
            "dateTo": "9999-12-31T00:00",
            "registrationDate": "2011-02-04T00:00",
            "deliveryAddress2": "Gatan225 13",
            "postalNumber": "13131",
            "city": "NACKA",
            "districtCode": "212104",
            "communeCode": "82",
            "countyCode": "01"
          }
        ]
      }
    }
  ]
}

Example: Personal Number Changed From | 199111029196

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2011-05-06T00:00",
      "personalNumber": "199111029196",
      "secrecyChangeDate": "2011-05-06T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2011-05-06T00:00",
          "dateTo": "9999-12-31T00:00",
          "firstName": "Martin Oskar",
          "surName": "Efternamn3227",
          "gender": "M",
          "birthDate": "1991-11-02T00:00",
          "personalNumberChangedFrom": "199111022399"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2011-05-06T00:00",
            "dateTo": "2015-12-18T00:00",
            "registrationDate": "1991-11-02T00:00",
            "deliveryAddress2": "Gatan330 3",
            "postalNumber": "98134",
            "city": "KIRUNA",
            "congregationCode": "02",
            "communeCode": "84",
            "countyCode": "25"
          },
          {
            "dateFrom": "2015-12-18T00:00",
            "dateTo": "9999-12-31T00:00",
            "registrationDate": "1991-11-02T00:00",
            "deliveryAddress2": "Gatan330 3",
            "postalNumber": "98134",
            "city": "KIRUNA",
            "districtCode": "324023",
            "communeCode": "84",
            "countyCode": "25"
          }
        ]
      }
    }
  ]
}

Example: Personal Number Changed To | 199111022399

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2011-05-02T00:00",
      "personalNumber": "199111022399",
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2011-05-02T00:00",
          "dateTo": "9999-12-31T00:00",
          "gender": "M",
          "birthDate": "1991-11-02T00:00",
          "deRegistrationReason": "G",
          "personalNumberChangedTo": "199111029196"
        },
        {
          "dateFrom": "2010-02-02T00:00",
          "dateTo": "2011-05-02T00:00",
          "firstName": "Martin Oskar",
          "surName": "Efternamn3227",
          "gender": "M",
          "birthDate": "1991-11-02T00:00"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2011-05-02T00:00",
            "registrationDate": "1991-11-02T00:00",
            "deliveryAddress2": "Gatan330 3",
            "postalNumber": "98134",
            "city": "KIRUNA",
            "congregationCode": "02",
            "communeCode": "84",
            "countyCode": "25"
          },
          {
            "dateFrom": "2011-05-02T00:00",
            "dateTo": "9999-12-31T00:00"
          }
        ]
      }
    }
  ]
}

Example: Reason for deregestering from the national registry, represented as a code G | 199111022399

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2011-05-02T00:00",
      "personalNumber": "199111022399",
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2011-05-02T00:00",
          "dateTo": "9999-12-31T00:00",
          "gender": "M",
          "birthDate": "1991-11-02T00:00",
          "deRegistrationReason": "G",
          "personalNumberChangedTo": "199111029196"
        },
        {
          "dateFrom": "2010-02-02T00:00",
          "dateTo": "2011-05-02T00:00",
          "firstName": "Martin Oskar",
          "surName": "Efternamn3227",
          "gender": "M",
          "birthDate": "1991-11-02T00:00"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "dateFrom": "2010-02-02T00:00",
            "dateTo": "2011-05-02T00:00",
            "registrationDate": "1991-11-02T00:00",
            "deliveryAddress2": "Gatan330 3",
            "postalNumber": "98134",
            "city": "KIRUNA",
            "congregationCode": "02",
            "communeCode": "84",
            "countyCode": "25"
          },
          {
            "dateFrom": "2011-05-02T00:00",
            "dateTo": "9999-12-31T00:00"
          }
        ]
      }
    }
  ]
}

Example: Reason for deregestering from the national registry, represented as a code A | 193604139208

{
  "posts": [
    {
      "nationalRegistryChangeDate": "2011-03-15T00:00",
      "personalNumber": "193604139208",
      "secrecyChangeDate": "2010-02-02T00:00",
      "secrecyMarked": false,
      "details": [
        {
          "dateFrom": "2010-02-02T00:00",
          "dateTo": "2011-03-15T00:00",
          "firstName": "Carina",
          "surName": "Efternamn1301",
          "gender": "F",
          "birthDate": "1936-04-13T00:00"
        },
        {
          "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": "2010-02-02T00:00",
            "dateTo": "2015-12-18T00:00",
            "registrationDate": "2002-09-01T00:00",
            "careOf": "CO-NAMN",
            "deliveryAddress2": "Gatan177 2",
            "postalNumber": "17890",
            "city": "EKERÖ",
            "congregationCode": "04",
            "communeCode": "25",
            "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 Social security number
Notification name 193701308888
National Registration Address 192907304766
Special Post Address 196805029268
Foreign Address 194812161596
History 197904182396
Personal Number Changed From 199111029196
Personal Number Changed To 199111022399
Reason for deregestering from the national registry, represented as a code G 199111022399
Reason for deregestering from the national registry, represented as a code A 193604139208

SE | Company Search API

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 Company Search 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 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

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

Example Response | Company name = Kommanditbolaget Porsen 17 | town= Sjömarken, statusCode = 100

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \ 
'https://api.roaring.io/se/company/search/1.1/search? \
companyName=Kommanditbolaget%20Porsen%2017&town=Sj% \
C3%B6marken&statusCode=100'

Response

{
  "hitCount": 1,
  "samples": [
    {
      "companyName": "KOMMANDITBOLAGET PORSEN 17",
      "legalGroupCode": "HB/KB",
      "legalGroupText": "Kommanditbolag",
      "town": "SJÖMARKEN",
      "links": [
        {
          "type": "company_economy_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/economy-overview/_rd67445f0d09791b1df2af576e9873c18"
        },
        {
          "type": "company_establishments",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/establishment/_rd67445f0d09791b1df2af576e9873c18"
        },
        {
          "type": "company_signatory",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/signatory/_rd67445f0d09791b1df2af576e9873c18"
        },
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/overview/_rd67445f0d09791b1df2af576e9873c18"
        },
        {
          "type": "company_board_members",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/board-members/_rd67445f0d09791b1df2af576e9873c18"
        }
      ]
    }
  ],
  "requests": [
    {
      "type": "company_economy_overview",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/economy-overview",
      "payload": {
        "requestKey": "acb0dd04-7cfb-4c99-9707-c87ca4b63d07"
      }
    },
    {
      "type": "company_establishments",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/establishment",
      "payload": {
        "requestKey": "acb0dd04-7cfb-4c99-9707-c87ca4b63d07"
      }
    },
    {
      "type": "company_signatory",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/signatory",
      "payload": {
        "requestKey": "acb0dd04-7cfb-4c99-9707-c87ca4b63d07"
      }
    },
    {
      "type": "company_overview",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/overview",
      "payload": {
        "requestKey": "acb0dd04-7cfb-4c99-9707-c87ca4b63d07"
      }
    },
    {
      "type": "company_board_members",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/board-members",
      "payload": {
        "requestKey": "acb0dd04-7cfb-4c99-9707-c87ca4b63d07"
      }
    }
  ],
  "status": 1
}

Example Response | Company name = Kommanditbolaget Porsen 17 | town= Sjömarken, statusCode = 100

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \
'https://api.roaring.io/se/company/search/1.1/search? \
companyName=Stiftelsen%20John%20S%C3%B6derbergs% \
20fond&town=stockholm'

Response

{
  "hitCount": 1,
  "samples": [
    {
      "companyName": "STIFTELSEN JOHN SÖDERBERGS FOND",
      "legalGroupCode": "OVR",
      "legalGroupText": "Stiftelse/Fond",
      "town": "STOCKHOLM",
      "links": [
        {
          "type": "company_economy_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/economy-overview/_r685fd045ae61008b4e229eddde7c24ae"
        },
        {
          "type": "company_establishments",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/establishment/_r685fd045ae61008b4e229eddde7c24ae"
        },
        {
          "type": "company_signatory",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/signatory/_r685fd045ae61008b4e229eddde7c24ae"
        },
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/overview/_r685fd045ae61008b4e229eddde7c24ae"
        },
        {
          "type": "company_board_members",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/board-members/_r685fd045ae61008b4e229eddde7c24ae"
        }
      ]
    }
  ],
  "requests": [
    {
      "type": "company_economy_overview",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/economy-overview",
      "payload": {
        "requestKey": "c737c2bb-01b1-4f57-8300-6d811b89e62d"
      }
    },
    {
      "type": "company_establishments",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/establishment",
      "payload": {
        "requestKey": "c737c2bb-01b1-4f57-8300-6d811b89e62d"
      }
    },
    {
      "type": "company_signatory",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/signatory",
      "payload": {
        "requestKey": "c737c2bb-01b1-4f57-8300-6d811b89e62d"
      }
    },
    {
      "type": "company_overview",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/overview",
      "payload": {
        "requestKey": "c737c2bb-01b1-4f57-8300-6d811b89e62d"
      }
    },
    {
      "type": "company_board_members",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/board-members",
      "payload": {
        "requestKey": "c737c2bb-01b1-4f57-8300-6d811b89e62d"
      }
    }
  ],
  "status": 1
}

Example Response | Company name = Torekovs | industryCode = 94990

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \
'https://api.roaring.io/se/company/search/1.1/search? \
companyName=Torekovs&industryCode=94990'

Response

{
  "hitCount": 5,
  "samples": [
    {
      "companyName": "TOREKOVS FÖRELÄSNINGSFÖRENING",
      "legalGroupCode": "OVR",
      "legalGroupText": "Ideell förening",
      "town": "BÅSTAD",
      "links": [
        {
          "type": "company_economy_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/economy-overview/_rdb530b86919a55c46fdeaff2698d114a"
        },
        {
          "type": "company_establishments",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/establishment/_rdb530b86919a55c46fdeaff2698d114a"
        },
        {
          "type": "company_signatory",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/signatory/_rdb530b86919a55c46fdeaff2698d114a"
        },
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/overview/_rdb530b86919a55c46fdeaff2698d114a"
        },
        {
          "type": "company_board_members",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/board-members/_rdb530b86919a55c46fdeaff2698d114a"
        }
      ]
    },
    {
      "companyName": "TOREKOVS SKIFTESLAG",
      "legalGroupCode": "OVR",
      "legalGroupText": "Ideell förening",
      "town": "TOREKOV",
      "links": [
        {
          "type": "company_economy_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/economy-overview/_ra7ad391c40be1deb8d8952ef79977952"
        },
        {
          "type": "company_establishments",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/establishment/_ra7ad391c40be1deb8d8952ef79977952"
        },
        {
          "type": "company_signatory",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/signatory/_ra7ad391c40be1deb8d8952ef79977952"
        },
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/overview/_ra7ad391c40be1deb8d8952ef79977952"
        },
        {
          "type": "company_board_members",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/board-members/_ra7ad391c40be1deb8d8952ef79977952"
        }
      ]
    },
    {
      "companyName": "Torekovs Sjöfartsmuseum",
      "legalGroupCode": "OVR",
      "legalGroupText": "Ideell förening",
      "town": "TOREKOV",
      "links": [
        {
          "type": "company_economy_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/economy-overview/_rb4d1e0aaa6e6fa456e753e646b254e22"
        },
        {
          "type": "company_establishments",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/establishment/_rb4d1e0aaa6e6fa456e753e646b254e22"
        },
        {
          "type": "company_signatory",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/signatory/_rb4d1e0aaa6e6fa456e753e646b254e22"
        },
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/overview/_rb4d1e0aaa6e6fa456e753e646b254e22"
        },
        {
          "type": "company_board_members",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/board-members/_rb4d1e0aaa6e6fa456e753e646b254e22"
        }
      ]
    },
    {
      "companyName": "MUNSKÄNKARNA TOREKOVSSEKTIONEN",
      "legalGroupCode": "OVR",
      "legalGroupText": "Ideell förening",
      "town": "TOREKOV",
      "links": [
        {
          "type": "company_economy_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/economy-overview/_ra1e8ad368eac307e2c300f89890853fa"
        },
        {
          "type": "company_establishments",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/establishment/_ra1e8ad368eac307e2c300f89890853fa"
        },
        {
          "type": "company_signatory",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/signatory/_ra1e8ad368eac307e2c300f89890853fa"
        },
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/overview/_ra1e8ad368eac307e2c300f89890853fa"
        },
        {
          "type": "company_board_members",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/board-members/_ra1e8ad368eac307e2c300f89890853fa"
        }
      ]
    },
    {
      "companyName": "FÖRENINGEN TOREKOVS GAMLA SKOLA",
      "legalGroupCode": "OVR",
      "legalGroupText": "Ideell förening",
      "town": "TOREKOV",
      "links": [
        {
          "type": "company_economy_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/economy-overview/_rc43d22df7441036a2574e64186698176"
        },
        {
          "type": "company_establishments",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/establishment/_rc43d22df7441036a2574e64186698176"
        },
        {
          "type": "company_signatory",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/signatory/_rc43d22df7441036a2574e64186698176"
        },
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/overview/_rc43d22df7441036a2574e64186698176"
        },
        {
          "type": "company_board_members",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/board-members/_rc43d22df7441036a2574e64186698176"
        }
      ]
    }
  ],
  "requests": [
    {
      "type": "company_economy_overview",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/economy-overview",
      "payload": {
        "requestKey": "bef5e77e-670a-481a-bdd2-fc510a18cb96"
      }
    },
    {
      "type": "company_establishments",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/establishment",
      "payload": {
        "requestKey": "bef5e77e-670a-481a-bdd2-fc510a18cb96"
      }
    },
    {
      "type": "company_signatory",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/signatory",
      "payload": {
        "requestKey": "bef5e77e-670a-481a-bdd2-fc510a18cb96"
      }
    },
    {
      "type": "company_overview",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/overview",
      "payload": {
        "requestKey": "bef5e77e-670a-481a-bdd2-fc510a18cb96"
      }
    },
    {
      "type": "company_board_members",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/board-members",
      "payload": {
        "requestKey": "bef5e77e-670a-481a-bdd2-fc510a18cb96"
      }
    }
  ],
  "status": 1
}

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
}

Example Response | county = VÄSTRA GÖTALAND | zipCode = 461 | industryCode = 70100 | legalGroupCode = AB | vatReg = 1 | statusCode = 100 | employerContributionReg = 1 | numberEmployees = 2

Request

curl -X GET --header 'Accept: application/json' \
--header 'Authorization: Bearer {ACCESS TOKEN}' \
'https://api.roaring.io/se/company/search/1.1/search? \
county=V%C3%84STRA%20G%C3%96TALAND&zipCode=461& \
industryCode=70100&legalGroupCode=AB&vatReg=1& \
statusCode=100&employerContributionReg=1&numberEmployees=2'

Response

{
  "hitCount": 2,
  "samples": [
    {
      "companyName": "Argynnis Group AB",
      "legalGroupCode": "AB",
      "legalGroupText": "Privat aktiebolag",
      "town": "TROLLHÄTTAN",
      "links": [
        {
          "type": "company_economy_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/economy-overview/_r14ebaa33b57a13c6f377f4fad89202b5"
        },
        {
          "type": "company_establishments",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/establishment/_r14ebaa33b57a13c6f377f4fad89202b5"
        },
        {
          "type": "company_signatory",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/signatory/_r14ebaa33b57a13c6f377f4fad89202b5"
        },
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/overview/_r14ebaa33b57a13c6f377f4fad89202b5"
        },
        {
          "type": "company_board_members",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/board-members/_r14ebaa33b57a13c6f377f4fad89202b5"
        }
      ]
    },
    {
      "companyName": "Swedec AB",
      "legalGroupCode": "AB",
      "legalGroupText": "Privat aktiebolag",
      "town": "TROLLHÄTTAN",
      "links": [
        {
          "type": "company_economy_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/economy-overview/_r53f0c47625186bbfca625db3e281eda0"
        },
        {
          "type": "company_establishments",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/establishment/_r53f0c47625186bbfca625db3e281eda0"
        },
        {
          "type": "company_signatory",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/signatory/_r53f0c47625186bbfca625db3e281eda0"
        },
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/overview/_r53f0c47625186bbfca625db3e281eda0"
        },
        {
          "type": "company_board_members",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/board-members/_r53f0c47625186bbfca625db3e281eda0"
        }
      ]
    }
  ],
  "requests": [
    {
      "type": "company_economy_overview",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/economy-overview",
      "payload": {
        "requestKey": "dbbded50-1961-4621-b592-a11d571cbbc9"
      }
    },
    {
      "type": "company_establishments",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/establishment",
      "payload": {
        "requestKey": "dbbded50-1961-4621-b592-a11d571cbbc9"
      }
    },
    {
      "type": "company_signatory",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/signatory",
      "payload": {
        "requestKey": "dbbded50-1961-4621-b592-a11d571cbbc9"
      }
    },
    {
      "type": "company_overview",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/overview",
      "payload": {
        "requestKey": "dbbded50-1961-4621-b592-a11d571cbbc9"
      }
    },
    {
      "type": "company_board_members",
      "method": "POST",
      "url": "https://api.roaring.io/se/company/board-members",
      "payload": {
        "requestKey": "dbbded50-1961-4621-b592-a11d571cbbc9"
      }
    }
  ],
  "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

SE | Company Simple Search API

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

Detailed SimpleSearch 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 portal.

Endpoint

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

Atributes

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

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

Example Response | Kommanditbolaget Porsen 17, Sjömarken

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=KOMMANDITBOLAGET%20PORSEN%2017&town=SJ%C3%96MARKEN'

Response

{
  "moreHits": false,
  "hitCount": 1,
  "matches": [
    {
      "companyName": "KOMMANDITBOLAGET PORSEN 17",
      "legalGroupCode": "HB/KB",
      "legalGroupText": "Kommanditbolag",
      "town": "SJÖMARKEN",
      "links": [
        {
          "type": "company_economy_overview",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-economy-overview?countryCode=se&companyId=9168937861"
        },
        {
          "type": "company_establishments",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/establishment/9168937861"
        },
        {
          "type": "company_signatory",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-signatory?countryCode=se&companyId=9168937861"
        },
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-overview?countryCode=se&companyId=9168937861"
        },
        {
          "type": "company_board_members",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-board-members?countryCode=se&companyId=9168937861"
        }
      ]
    }
  ]
}

Example Response | Bostadsrättsföreningen Kamelian 4, Stockholm

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=Bostadsr%C3%A4ttsf%C3%B6reningen%20Kamelian%204&town=stockholm'

Response

{
  "moreHits": false,
  "hitCount": 1,
  "matches": [
    {
      "companyName": "Bostadsrättsföreningen Kamelian 4",
      "legalGroupCode": "OVR",
      "legalGroupText": "Bostadsrättsförening",
      "town": "STOCKHOLM",
      "links": [
        {
          "type": "company_economy_overview",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-economy-overview?countryCode=se&companyId=7696053631"
        },
        {
          "type": "company_establishments",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/establishment/7696053631"
        },
        {
          "type": "company_signatory",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-signatory?countryCode=se&companyId=7696053631"
        },
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-overview?countryCode=se&companyId=7696053631"
        },
        {
          "type": "company_board_members",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-board-members?countryCode=se&companyId=7696053631"
        }
      ]
    }
  ]
}

Example Response | Stiftelsen John Söderbergs fond, Stockholm

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=Stiftelsen%20John%20S%C3%B6derbergs%20fond&town=Stockholm'

Response

{
  "moreHits": false,
  "hitCount": 1,
  "matches": [
    {
      "companyName": "STIFTELSEN JOHN SÖDERBERGS FOND",
      "legalGroupCode": "OVR",
      "legalGroupText": "Stiftelse/Fond",
      "town": "STOCKHOLM",
      "links": [
        {
          "type": "company_economy_overview",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-economy-overview?countryCode=se&companyId=8024045489"
        },
        {
          "type": "company_establishments",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/establishment/8024045489"
        },
        {
          "type": "company_signatory",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-signatory?countryCode=se&companyId=8024045489"
        },
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-overview?countryCode=se&companyId=8024045489"
        },
        {
          "type": "company_board_members",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-board-members?countryCode=se&companyId=8024045489"
        }
      ]
    }
  ]
}

Example Response | Torekovs föreläsningsförening, Båstad

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=Torekovs%20f%C3%B6rel%C3%A4sningsf%C3%B6rening&town=B%C3%A5stad'

Response

{
  "moreHits": false,
  "hitCount": 1,
  "matches": [
    {
      "companyName": "TOREKOVS FÖRELÄSNINGSFÖRENING",
      "legalGroupCode": "OVR",
      "legalGroupText": "Ideell förening",
      "town": "BÅSTAD",
      "links": [
        {
          "type": "company_economy_overview",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-economy-overview?countryCode=se&companyId=8394004322"
        },
        {
          "type": "company_establishments",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/establishment/8394004322"
        },
        {
          "type": "company_signatory",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-signatory?countryCode=se&companyId=8394004322"
        },
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-overview?countryCode=se&companyId=8394004322"
        },
        {
          "type": "company_board_members",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-board-members?countryCode=se&companyId=8394004322"
        }
      ]
    }
  ]
}

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"
        }
      ]
    }
  ]
}

Example Response | Aronfors Bygg och Teknik Aktiebola, Munkedal

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=Aronfors%20Bygg%20och%20Teknik%20Aktiebola&town=Munkedal'

Response

{
  "moreHits": false,
  "hitCount": 1,
  "matches": [
    {
      "companyName": "Aronfors Bygg och Teknik Aktiebolag",
      "legalGroupCode": "AB",
      "legalGroupText": "Privat aktiebolag",
      "town": "MUNKEDAL",
      "links": [
        {
          "type": "company_economy_overview",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-economy-overview?countryCode=se&companyId=5564866803"
        },
        {
          "type": "company_establishments",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/establishment/5564866803"
        },
        {
          "type": "company_signatory",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-signatory?countryCode=se&companyId=5564866803"
        },
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-overview?countryCode=se&companyId=5564866803"
        },
        {
          "type": "company_board_members",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-board-members?countryCode=se&companyId=5564866803"
        }
      ]
    }
  ]
}

Example Response | Atsol AB, Malmö

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=Atsol%20AB&town=Malm%C3%B6'

Response

{
  "moreHits": false,
  "hitCount": 1,
  "matches": [
    {
      "companyName": "Atsol AB",
      "legalGroupCode": "AB",
      "legalGroupText": "Privat aktiebolag",
      "town": "MALMÖ",
      "links": [
        {
          "type": "company_economy_overview",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-economy-overview?countryCode=se&companyId=5569994600"
        },
        {
          "type": "company_establishments",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/establishment/5569994600"
        },
        {
          "type": "company_signatory",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-signatory?countryCode=se&companyId=5569994600"
        },
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-overview?countryCode=se&companyId=5569994600"
        },
        {
          "type": "company_board_members",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-board-members?countryCode=se&companyId=5569994600"
        }
      ]
    }
  ]
}

Example Response | ACM 2001 AB, Stockholm

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=ACM%202001%20AB&town=Stockholm'

Response

{
  "moreHits": false,
  "hitCount": 1,
  "matches": [
    {
      "companyName": "ACM 2001 AB",
      "legalGroupCode": "AB",
      "legalGroupText": "Privat aktiebolag",
      "town": "STOCKHOLM",
      "links": [
        {
          "type": "company_economy_overview",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-economy-overview?countryCode=se&companyId=5560572850"
        },
        {
          "type": "company_establishments",
          "method": "GET",
          "url": "https://api.roaring.io/se/company/establishment/5560572850"
        },
        {
          "type": "company_signatory",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-signatory?countryCode=se&companyId=5560572850"
        },
        {
          "type": "company_overview",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-overview?countryCode=se&companyId=5560572850"
        },
        {
          "type": "company_board_members",
          "method": "GET",
          "url": "https://api.roaring.io/company/company-board-members?countryCode=se&companyId=5560572850"
        }
      ]
    }
  ]
}
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

SE | Company Overview API

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 Company 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
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 | Company Overview

Example: Kommanditbolag | 9168937861

Request

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

Response

{
  "companyId": "9168937861",
  "changeDate": "2016-12-10",
  "statusCode": "100",
  "statusTextHigh": "Aktivt",
  "statusTextDetailed": "Aktivt",
  "statusDateFrom": "19870714",
  "companyName": "KOMMANDITBOLAGET PORSEN 17",
  "severalCompanyName": false,
  "coAddress": "c/o B Starnäs",
  "address": "Vinkelvägen 3",
  "zipCode": "51841",
  "town": "SJÖMARKEN",
  "commune": "BORÅS",
  "county": "VÄSTRA GÖTALAND",
  "legalGroupCode": "HB/KB",
  "legalGroupText": "Kommanditbolag",
  "preliminaryTaxReg": "0",
  "companyRegistrationDate": "1987-07-14",
  "industryCode": "68201",
  "industryText": "Fastighetsbolag, bostäder"
}

Example: Bostadsrättsförening | 7696053631 |

Request

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

Response

{
  "companyId": "7696053631",
  "changeDate": "2016-12-10",
  "statusCode": "100",
  "statusTextHigh": "Aktivt",
  "statusTextDetailed": "Aktivt",
  "statusDateFrom": "20000214",
  "companyName": "Bostadsrättsföreningen Kamelian 4",
  "severalCompanyName": false,
  "coAddress": " ",
  "address": "Box 12871",
  "zipCode": "11298",
  "town": "STOCKHOLM",
  "commune": "STOCKHOLM",
  "county": "STOCKHOLM",
  "phoneNumber": "08-7325270",
  "legalGroupCode": "OVR",
  "legalGroupText": "Bostadsrättsförening",
  "preliminaryTaxReg": "1",
  "employerContributionReg": "1",
  "vatReg": "1",
  "vepChangedDate": "20051201",
  "companyRegistrationDate": "2000-02-14",
  "industryCode": "68204",
  "industryText": "Bostadsrättsföreningar",
  "numberCompanyUnits": 1
}

Example: Samfällighetsförening | 717913520

Request

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

Response

{
  "companyId": "7179135202",
  "changeDate": "2016-12-10",
  "statusCode": "109",
  "statusTextHigh": "Ingen status information finns",
  "statusTextDetailed": "Ingen status information finns",
  "statusDateFrom": "20120419",
  "companyName": "Rommenäs-Erlandstorp Samfällighetsförening",
  "severalCompanyName": false,
  "coAddress": "Göte Carlsson",
  "address": "Erlandstorp 1",
  "zipCode": "57021",
  "town": "MALMBÄCK",
  "commune": "NÄSSJÖ",
  "county": "JÖNKÖPING",
  "legalGroupCode": "OVR",
  "legalGroupText": "Samfällighet",
  "preliminaryTaxReg": "0",
  "companyRegistrationDate": "2012-04-19",
  "industryCode": "68209",
  "industryText": "Övriga fastighetsbolag"
}

Example: Stiftelse | 8024045489

Request

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

Response

{
  "companyId": "8024045489",
  "changeDate": "2016-12-10",
  "statusCode": "109",
  "statusTextHigh": "Ingen status information finns",
  "statusTextDetailed": "Ingen status information finns",
  "statusDateFrom": "19970910",
  "companyName": "STIFTELSEN JOHN SÖDERBERGS FOND",
  "severalCompanyName": false,
  "coAddress": "Stockholms Universitet",
  "address": "Ekonomiavdelningen",
  "zipCode": "10691",
  "town": "STOCKHOLM",
  "commune": "STOCKHOLM",
  "county": "STOCKHOLM",
  "legalGroupCode": "OVR",
  "legalGroupText": "Stiftelse/Fond",
  "preliminaryTaxReg": "0",
  "companyRegistrationDate": "1997-09-10",
  "industryCode": "00009",
  "industryText": "Huvudnäring okänd"
}

Example: Ideell förening | 8394004322

Request

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

Response

{
  "companyId": "8394004322",
  "changeDate": "2016-12-10",
  "statusCode": "109",
  "statusTextHigh": "Ingen status information finns",
  "statusTextDetailed": "Ingen status information finns",
  "statusDateFrom": "20100427",
  "companyName": "TOREKOVS FÖRELÄSNINGSFÖRENING",
  "severalCompanyName": false,
  "coAddress": "Ingegärd Rayman",
  "address": "Källs Vångaväg 136",
  "zipCode": "26995",
  "town": "BÅSTAD",
  "commune": "BÅSTAD",
  "county": "SKÅNE",
  "visitAddress": "Källs Vångaväg 136",
  "visitStreet": "Källs Vångaväg",
  "visitStreetNumber": "136",
  "visitZipCode": "26995",
  "visitTown": "Båstad",
  "visitCommune": "BÅSTAD",
  "visitCounty": "SKÅNE",
  "legalGroupCode": "OVR",
  "legalGroupText": "Ideell förening",
  "preliminaryTaxReg": "0",
  "employerContributionReg": "1",
  "vatReg": "0",
  "companyRegistrationDate": "1979-01-01",
  "industryCode": "94990",
  "industryText": "Andra intresseorganisationer",
  "numberCompanyUnits": 1
}

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: 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/overview/1.1/5567164818'

Response

{
  "companyId": "5567164818",
  "changeDate": "2016-12-10",
  "statusCode": "100",
  "statusTextHigh": "Aktivt",
  "statusTextDetailed": "Aktivt",
  "statusDateFrom": "20061127",
  "companyName": "Swedec AB",
  "severalCompanyName": false,
  "address": "Åkerssjövägen 52",
  "zipCode": "46153",
  "town": "TROLLHÄTTAN",
  "commune": "TROLLHÄTTAN",
  "county": "VÄSTRA GÖTALAND",
  "visitAddress": "Åkerssjövägen 52",
  "visitStreet": "Åkerssjövägen",
  "visitStreetNumber": "52",
  "visitZipCode": "46153",
  "visitTown": "Trollhättan",
  "visitCommune": "TROLLHÄTTAN",
  "visitCounty": "VÄSTRA GÖTALAND",
  "phoneNumber": "0706-646428",
  "legalGroupCode": "AB",
  "legalGroupText": "Privat aktiebolag",
  "preliminaryTaxReg": "1",
  "employerContributionReg": "1",
  "vatReg": "1",
  "vepChangedDate": "20080703",
  "companyRegistrationDate": "2006-11-27",
  "industryCode": "70100",
  "industryText": "Huvudkontor",
  "numberCompanyUnits": 1,
  "numberEmployees": "2"
}

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

Request

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

Response

{
  "companyId": "5564866803",
  "changeDate": "2016-12-10",
  "statusCode": "100",
  "statusTextHigh": "Aktivt",
  "statusTextDetailed": "Aktivt",
  "statusDateFrom": "19940425",
  "companyName": "Aronfors Bygg och Teknik Aktiebolag",
  "severalCompanyName": false,
  "address": "Hededalsvägen 20",
  "zipCode": "45534",
  "town": "MUNKEDAL",
  "commune": "MUNKEDAL",
  "county": "VÄSTRA GÖTALAND",
  "visitAddress": "Hededalsvägen 20",
  "visitStreet": "Hededalsvägen",
  "visitStreetNumber": "20",
  "visitZipCode": "45534",
  "visitTown": "Munkedal",
  "visitCommune": "MUNKEDAL",
  "visitCounty": "VÄSTRA GÖTALAND",
  "phoneNumber": "0524-12500",
  "legalGroupCode": "AB",
  "legalGroupText": "Privat aktiebolag",
  "preliminaryTaxReg": "1",
  "employerContributionReg": "1",
  "vatReg": "1",
  "vepChangedDate": "19940101",
  "companyRegistrationDate": "1994-04-25",
  "industryCode": "41200",
  "industryText": "Entreprenörer för bostadshus och andra byggnader",
  "topDirectorName": "Nils-Eric Forslund",
  "topDirectorFunction": "Verkställande direktör",
  "numberCompanyUnits": 1,
  "numberEmployees": "2"
}

Example: Aktiebolag (Active company, registered for tax, head office.) | 5569994600

Request

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

Response

{
  "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"
}

Example: Aktiebolag (Liquidation approved, C/O address) | 5590506506

Request

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

Response

{
  "companyId": "5590506506",
  "changeDate": "2016-12-10",
  "statusCode": "132",
  "statusTextHigh": "Likvidation beslutad",
  "statusTextDetailed": "Likvidation beslutad",
  "statusDateFrom": "20161026",
  "companyName": "SNW Fastigheter 2 AB",
  "severalCompanyName": false,
  "coAddress": "c/o Ekonominord",
  "address": "Box 4185",
  "zipCode": "90405",
  "town": "UMEÅ",
  "commune": "UMEÅ",
  "county": "VÄSTERBOTTEN",
  "legalGroupCode": "AB",
  "legalGroupText": "Privat aktiebolag",
  "preliminaryTaxReg": "0",
  "companyRegistrationDate": "2016-02-09",
  "industryCode": "00009",
  "industryText": "Huvudnäring okänd"
}

Example: Aktiebolag (Active company, merger completed.) | 5560572850

Request

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

Response

{
  "companyId": "5560572850",
  "changeDate": "2016-12-10",
  "statusCode": "141",
  "statusTextHigh": "Aktivt",
  "statusTextDetailed": "Fusion avslutad",
  "statusDateFrom": "20071116",
  "companyName": "ACM 2001 AB",
  "severalCompanyName": false,
  "address": "Box 213",
  "zipCode": "10124",
  "town": "STOCKHOLM",
  "commune": "STOCKHOLM",
  "county": "STOCKHOLM",
  "visitAddress": "Adolf Fredriks Kyrkogata 2",
  "visitStreet": "Adolf Fredriks Kyrkogata",
  "visitStreetNumber": "2",
  "visitZipCode": "11137",
  "visitTown": "Stockholm",
  "visitCommune": "STOCKHOLM",
  "visitCounty": "STOCKHOLM",
  "phoneNumber": "08-7944200",
  "email": "info@academedia.se",
  "webAddress": "www.academedia.se",
  "legalGroupCode": "AB",
  "legalGroupText": "Privat aktiebolag",
  "preliminaryTaxReg": "1",
  "employerContributionReg": "1",
  "vatReg": "1",
  "vepChangedDate": "19980101",
  "companyRegistrationDate": "1952-10-22",
  "industryCode": "85600",
  "industryText": "Stödföretag inom utbildningsväsendet",
  "numberCompanyUnits": 1,
  "numberEmployees": "5"
}

Example: Aktiebolag (Bankruptcy) | 5569030264

Request

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

Response

{
  "companyId": "5569030264",
  "changeDate": "2016-12-10",
  "statusCode": "190",
  "statusTextHigh": "Konkursbeslut",
  "statusTextDetailed": "Konkursbeslut",
  "statusDateFrom": "20151218",
  "companyName": "Armina AB",
  "severalCompanyName": false,
  "coAddress": "c/o Advokatbyrån Eriksson & Bengtsson",
  "address": "Västerbrogatan 8",
  "zipCode": "50330",
  "town": "BORÅS",
  "commune": "BORÅS",
  "county": "VÄSTRA GÖTALAND",
  "phoneNumber": "0730-209999",
  "legalGroupCode": "AB",
  "legalGroupText": "Privat aktiebolag",
  "preliminaryTaxReg": "0",
  "employerContributionReg": "0",
  "vatReg": "0",
  "companyRegistrationDate": "2012-09-06",
  "industryCode": "00009",
  "industryText": "Huvudnäring okänd",
  "numberEmployees": "1"
}

Example: Enskild firma | 7904182396

Request

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

Response

{
  "companyId": "7904182396",
  "changeDate": "2016-12-10",
  "statusCode": "100",
  "statusTextHigh": "Aktivt",
  "statusTextDetailed": "Aktivt",
  "statusDateFrom": "20000216",
  "companyName": "Kuno Efternamn2993",
  "severalCompanyName": false,
  "address": "Kungs 6",
  "zipCode": "12345",
  "town": "HALL",
  "commune": "HALL",
  "county": "HALLAND",
  "visitAddress": "Kungs 6",
  "visitStreet": "Kungs",
  "visitStreetNumber": "6",
  "visitZipCode": "12345",
  "visitTown": "Hall",
  "visitCommune": "HALL",
  "visitCounty": "HALLAND",
  "phoneNumber": "0300-12345",
  "legalGroupCode": "EF",
  "legalGroupText": "Enskild firma",
  "preliminaryTaxReg": "1",
  "employerContributionReg": "0",
  "vatReg": "1",
  "vepChangedDate": "20000314",
  "companyRegistrationDate": "2000-02-16",
  "industryCode": "28300",
  "industryText": "Industri för jord- och skogsbruksmaskiner ",
  "numberCompanyUnits": 1
}

Example: Enskild firma | 6805029268

Request

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

Response

{
  "companyId": "6805029268",
  "changeDate": "2016-12-10",
  "statusCode": "100",
  "statusTextHigh": "Aktivt",
  "statusTextDetailed": "Aktivt",
  "statusDateFrom": "19960109",
  "companyName": "Petra Efternamn2401",
  "severalCompanyName": false,
  "coAddress": " ",
  "address": "Gatan140 11",
  "zipCode": "98131",
  "town": "KIRUNA",
  "commune": "KIRUNA",
  "county": "KIRUNA",
  "visitAddress": "Gatan140 11",
  "visitStreet": "Gatan140",
  "visitStreetNumber": "11",
  "visitZipCode": "98131",
  "visitTown": "Kiruna",
  "visitCommune": "KIRUNA",
  "visitCounty": "KIRUNA",
  "phoneNumber": "040-12345",
  "legalGroupCode": "EF",
  "legalGroupText": "Enskild firma",
  "preliminaryTaxReg": "0",
  "employerContributionReg": "0",
  "vatReg": "1",
  "companyRegistrationDate": "1996-01-09",
  "companyDeRegistrationDate": "20100329",
  "industryCode": "73119",
  "industryText": "Övriga reklamföretag",
  "numberCompanyUnits": 1
}

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

SE | Company Economy Overview API

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 Company Economy Overview 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
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 | Economy Overview

Example: Kommanditbolag | 9168937861

Request

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

Response

{
  "companyId": "9168937861",
  "changeDate": "2016-12-10",
  "bsShareCapital": "0",
  "nbrOfEmployees": "0",
  "nbrOfEmployeesInterval": "0 anställda",
  "nbrOfEmployeesOfficeInterval": "Okänt antal kontorsanställda",
  "netTurnover": "0",
  "turnoverPerEmployee": "0",
  "plOperatingProfit": "0",
  "plProfitLossAfterFinItems": "0",
  "plNetIncome": "0",
  "bsTotalEquity": "0",
  "bsTotalAssets": "0",
  "bsCashAndBankBalances": "0",
  "kpiSolidityPercent": "0",
  "kpiQuickRatioPercent": "0",
  "kpiNetMarginPercent": "0"
}

Example: Bostadsrättsförening | 7696053631 |

Request

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

Response

{
  "companyId": "7696053631",
  "changeDate": "2016-12-10",
  "bsShareCapital": "0",
  "nbrOfEmployees": "0",
  "nbrOfEmployeesInterval": "0 anställda",
  "nbrOfEmployeesOfficeInterval": "Okänt antal kontorsanställda",
  "netTurnover": "0",
  "turnoverInterval": "750 - 999 tkr",
  "turnoverPerEmployee": "0",
  "plOperatingProfit": "0",
  "plProfitLossAfterFinItems": "0",
  "plNetIncome": "0",
  "bsTotalEquity": "0",
  "bsTotalAssets": "0",
  "bsCashAndBankBalances": "0",
  "kpiSolidityPercent": "0",
  "kpiQuickRatioPercent": "0",
  "kpiNetMarginPercent": "0"
}

Example: Samfällighetsförening | 717913520

Request

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

Response

{
  "companyId": "7179135202",
  "changeDate": "2016-12-10",
  "bsShareCapital": "0",
  "nbrOfEmployees": "0",
  "nbrOfEmployeesInterval": "Uppgift saknas",
  "netTurnover": "0",
  "turnoverPerEmployee": "0",
  "plOperatingProfit": "0",
  "plProfitLossAfterFinItems": "0",
  "plNetIncome": "0",
  "bsTotalEquity": "0",
  "bsTotalAssets": "0",
  "bsCashAndBankBalances": "0",
  "kpiSolidityPercent": "0",
  "kpiQuickRatioPercent": "0",
  "kpiNetMarginPercent": "0"
}

Example: Stiftelse | 8024045489

Request

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

Response

{
  "companyId": "8024045489",
  "changeDate": "2016-12-10",
  "bsShareCapital": "0",
  "nbrOfEmployees": "0",
  "nbrOfEmployeesInterval": "0 anställda",
  "nbrOfEmployeesOfficeInterval": "Okänt antal kontorsanställda",
  "netTurnover": "0",
  "turnoverPerEmployee": "0",
  "plOperatingProfit": "0",
  "plProfitLossAfterFinItems": "0",
  "plNetIncome": "0",
  "bsTotalEquity": "0",
  "bsTotalAssets": "0",
  "bsCashAndBankBalances": "0",
  "kpiSolidityPercent": "0",
  "kpiQuickRatioPercent": "0",
  "kpiNetMarginPercent": "0"
}

Example: Ideell förening | 8394004322

Request

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

Response

{
  "companyId": "8394004322",
  "changeDate": "2016-12-10",
  "bsShareCapital": "0",
  "nbrOfEmployees": "0",
  "nbrOfEmployeesInterval": "0 anställda",
  "nbrOfEmployeesOfficeInterval": "Okänt antal kontorsanställda",
  "netTurnover": "0",
  "turnoverPerEmployee": "0",
  "plOperatingProfit": "0",
  "plProfitLossAfterFinItems": "0",
  "plNetIncome": "0",
  "bsTotalEquity": "0",
  "bsTotalAssets": "0",
  "bsCashAndBankBalances": "0",
  "kpiSolidityPercent": "0",
  "kpiQuickRatioPercent": "0",
  "kpiNetMarginPercent": "0"
}

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"
}

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

Request

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

Response

{
  "companyId": "5567164818",
  "changeDate": "2016-12-10",
  "bsShareCapital": "100",
  "nbrOfEmployees": "2",
  "nbrOfEmployeesInterval": "1-4 anställda",
  "nbrOfEmployeesOfficeInterval": "Okänt antal kontorsanställda",
  "netTurnover": "1635",
  "turnoverInterval": "1000 - 2499 tkr",
  "turnoverPerEmployee": "818",
  "plOperatingProfit": "644",
  "plProfitLossAfterFinItems": "-888",
  "plNetIncome": "-1017",
  "bsTotalEquity": "1707",
  "bsTotalAssets": "4336",
  "bsCashAndBankBalances": "430",
  "kpiSolidityPercent": "60.2",
  "kpiQuickRatioPercent": "62.5",
  "kpiNetMarginPercent": "-54.3"
}

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

Request

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

Response

{
  "companyId": "5564866803",
  "changeDate": "2016-12-10",
  "bsShareCapital": "100",
  "nbrOfEmployees": "2",
  "nbrOfEmployeesInterval": "0 anställda",
  "nbrOfEmployeesOfficeInterval": "0         kontorsanställda",
  "netTurnover": "3135",
  "turnoverInterval": "1000 - 2499 tkr",
  "turnoverPerEmployee": "1568",
  "plOperatingProfit": "-657",
  "plProfitLossAfterFinItems": "-375",
  "plNetIncome": "5",
  "bsTotalEquity": "8857",
  "bsTotalAssets": "10366",
  "bsCashAndBankBalances": "4157",
  "kpiSolidityPercent": "86.5",
  "kpiQuickRatioPercent": "536.2",
  "kpiNetMarginPercent": "-12"
}

Example: Aktiebolag (Active company, registered for tax, head office.) | 5569994600

Request

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

Response

{
  "companyId": "5569994600",
  "changeDate": "2016-12-10",
  "bsShareCapital": "50",
  "nbrOfEmployees": "1",
  "nbrOfEmployeesInterval": "1-4 anställda",
  "netTurnover": "1887",
  "turnoverInterval": "1 - 49 tkr",
  "turnoverPerEmployee": "1887",
  "plOperatingProfit": "-36",
  "plProfitLossAfterFinItems": "-35",
  "plNetIncome": "-35",
  "bsTotalEquity": "832",
  "bsTotalAssets": "931",
  "bsCashAndBankBalances": "181",
  "kpiSolidityPercent": "89.4",
  "kpiQuickRatioPercent": "561.2",
  "kpiNetMarginPercent": "-1.9"
}

Example: Aktiebolag (Liquidation approved, C/O address) | 5590506506

Request

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

Response

{
  "companyId": "5590506506",
  "changeDate": "2016-12-10",
  "bsShareCapital": "0",
  "nbrOfEmployees": "0",
  "nbrOfEmployeesInterval": "Uppgift saknas",
  "netTurnover": "0",
  "turnoverPerEmployee": "0",
  "plOperatingProfit": "0",
  "plProfitLossAfterFinItems": "0",
  "plNetIncome": "0",
  "bsTotalEquity": "0",
  "bsTotalAssets": "0",
  "bsCashAndBankBalances": "0",
  "kpiSolidityPercent": "0",
  "kpiQuickRatioPercent": "0",
  "kpiNetMarginPercent": "0"
}

Example: Aktiebolag (Active company, merger completed.) | 5560572850

Request

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

Response

{
  "companyId": "5560572850",
  "changeDate": "2016-12-10",
  "bsShareCapital": "24123",
  "nbrOfEmployees": "5",
  "nbrOfEmployeesInterval": "5-9 anställda",
  "nbrOfEmployeesOfficeInterval": "Okänt antal kontorsanställda",
  "netTurnover": "2131",
  "turnoverInterval": "1000 - 2499 tkr",
  "turnoverPerEmployee": "426",
  "plOperatingProfit": "-21989",
  "plProfitLossAfterFinItems": "-81497",
  "plNetIncome": "15826",
  "bsTotalEquity": "1656705",
  "bsTotalAssets": "4010724",
  "bsCashAndBankBalances": "384887",
  "kpiSolidityPercent": "41.3",
  "kpiQuickRatioPercent": "37.1",
  "kpiNetMarginPercent": "-3824.4"
}

Example: Aktiebolag (Bankruptcy) | 5569030264

Request

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

Response

{
  "companyId": "5569030264",
  "changeDate": "2016-12-10",
  "bsShareCapital": "50",
  "nbrOfEmployees": "1",
  "nbrOfEmployeesInterval": "0 anställda",
  "netTurnover": "819",
  "turnoverInterval": "< 1 tkr",
  "turnoverPerEmployee": "819",
  "plOperatingProfit": "-524",
  "plProfitLossAfterFinItems": "-530",
  "plNetIncome": "-530",
  "bsTotalEquity": "320",
  "bsTotalAssets": "1087",
  "bsCashAndBankBalances": "142",
  "kpiSolidityPercent": "29.4",
  "kpiQuickRatioPercent": "241.4",
  "kpiNetMarginPercent": "-64.7"
}

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

SE | Company Establishments API

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 Company Establishment 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 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 | Establishments

Example: Bostadsrättsförening | 7696053631 |

Request

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

Response

{
  "companyId": "7696053631",
  "changeDate": "2016-12-10",
  "establishments": [
    {
      "companyEstablishmentNumber": "44204402",
      "establishmentOfficeName": "Bostadsrättsföreningen Kamelian 4",
      "establishmentOfficeType": "Huvudkontor",
      "establishmentCoAddress": "Fastighetsägarna Stockholm Ab",
      "establishmentAddress": "Box 12871",
      "establishmentZipCode": "11298",
      "establishmentTown": "Stockholm",
      "establishmentVisitTown": "Stockholm",
      "phoneNumber": "08-7325270",
      "industryCode": "68204",
      "industryText": "Bostadsrättsförening",
      "commercialBlockText": "Tar emot reklam",
      "numberEmployeesInterval": "0 anställda"
    }
  ]
}

Example: Ideell förening | 8394004322

Request

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

Response

{
  "companyId": "8394004322",
  "changeDate": "2016-12-10",
  "establishments": [
    {
      "companyEstablishmentNumber": "43322940",
      "establishmentOfficeName": "Torekovs Föreläsningsförening",
      "establishmentOfficeType": "Huvudkontor",
      "establishmentCoAddress": "Ingegärd Rayman",
      "establishmentAddress": "Källs Vångaväg 136",
      "establishmentZipCode": "26995",
      "establishmentTown": "Båstad",
      "establishmentVisitAddress": "Källs Vångaväg 136",
      "establishmentVisitZipCode": "26995",
      "establishmentVisitTown": "Båstad",
      "industryCode": "94990",
      "industryText": "Ideell, kulturell organisation",
      "commercialBlockText": "Tar emot reklam",
      "numberEmployeesInterval": "0 anställda"
    }
  ]
}

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"
    }
  ]
}

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

Request

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

Response

{
  "companyId": "5564866803",
  "changeDate": "2016-12-10",
  "establishments": [
    {
      "companyEstablishmentNumber": "32083297",
      "establishmentOfficeName": "Aronfors Bygg och Teknik Aktiebolag",
      "establishmentOfficeType": "Huvudkontor",
      "establishmentAddress": "Box 49",
      "establishmentZipCode": "45521",
      "establishmentTown": "Munkedal",
      "establishmentVisitAddress": "Hededalsvägen 20",
      "establishmentVisitZipCode": "45534",
      "establishmentVisitTown": "Munkedal",
      "phoneNumber": "0524-12500",
      "industryCode": "41200",
      "industryText": "Byggentreprenör",
      "commercialBlockText": "Tar emot reklam",
      "numberEmployeesInterval": "0 anställda"
    }
  ]
}

Example: Aktiebolag (Active company, registered for tax, head office.) | 5569994600

Request

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

Response

{
  "companyId": "5569994600",
  "changeDate": "2016-12-10",
  "establishments": [
    {
      "companyEstablishmentNumber": "56037757",
      "establishmentOfficeName": "Atsol AB",
      "establishmentOfficeType": "Huvudkontor",
      "establishmentAddress": "Norra Parkgatan 3 LGH 1402",
      "establishmentZipCode": "21153",
      "establishmentTown": "Malmö",
      "establishmentVisitAddress": "Roskildevägen",
      "establishmentVisitZipCode": "21147",
      "establishmentVisitTown": "Malmö",
      "industryCode": "64993",
      "industryText": "Värdepapper, sluten förvaltning",
      "commercialBlockText": "Tar emot reklam",
      "numberEmployeesInterval": "1-4 anställda"
    }
  ]
}

Example: Aktiebolag (Active company, merger completed.) | 5560572850

Request

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

Response

{
  "companyId": "5560572850",
  "changeDate": "2016-12-10",
  "establishments": [
    {
      "companyEstablishmentNumber": "48022966",
      "establishmentOfficeName": "Acm 2001 AB",
      "establishmentOfficeType": "Huvudkontor",
      "establishmentAddress": "Adolf Fredriks Kyrkogata 2",
      "establishmentZipCode": "11137",
      "establishmentTown": "Stockholm",
      "establishmentVisitAddress": "Adolf Fredriks Kyrkogata 2",
      "establishmentVisitZipCode": "11137",
      "establishmentVisitTown": "Stockholm",
      "phoneNumber": "08-7944200",
      "email": "info@academedia.se",
      "industryCode": "85600",
      "industryText": "Utbildningsserviceföretag",
      "commercialBlockText": "Tar emot reklam",
      "numberEmployeesInterval": "5-9 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

SE | Company 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 Company Credit Decision 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
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 for Company Credit Decision

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 | 9696373076

Request

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

Response

{
  "companyId": "9696373076",
  "rejections": [
    {
      "rejectComment": "",
      "causeOfReject": "6",
      "rejectText": "Incorrect info XML code"
    }
  ],
  "statusText": "Not Approved",
  "statusCode": "2"
}

Example: Not Approved | 5563260701

Request

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

Response

{
  "companyId": "5563260701",
  "rejections": [
    {
      "rejectComment": "",
      "causeOfReject": "7",
      "rejectText": "No access to this product"
    }
  ],
  "statusText": "Not Approved",
  "statusCode": "2"
}

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"
}

Example: Not Approved | 5567164818

Request

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

Response

{
  "companyId": "5567164818",
  "rejections": [
    {
      "rejectComment": "",
      "causeOfReject": "11",
      "rejectText": "Wrong block"
    }
  ],
  "statusText": "Not Approved",
  "statusCode": "2"
}

Example: Not Approved | 5567664601

Request

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

Response

{
  "companyId": "5567664601",
  "rejections": [
    {
      "rejectComment": "",
      "causeOfReject": "12",
      "rejectText": "Wrong template"
    }
  ],
  "statusText": "Not Approved",
  "statusCode": "2"
}

Example: Not Approved | 5561289744

Request

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

Response

{
  "companyId": "5561289744",
  "rejections": [
    {
      "rejectComment": "",
      "causeOfReject": "13",
      "rejectText": "Security validation not ok"
    }
  ],
  "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

SE | Company Engagements API

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 Company Engagement 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
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 | Engagements

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 | Engagements

Example: 192907304766

Request

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

Response

{
  "hitCount": 6,
  "personalNumber": "192907304766",
  "engagements": [
    {
      "companyId": "5565002465",
      "companyName": "Wilfast Högsbo Aktiebolag",
      "statusCode": 100,
      "statusText": "Aktivt",
      "roleCode": 5,
      "roleName": "Ledamot",
      "town": "GÖTEBORG"
    },
    {
      "companyId": "5569979734",
      "companyName": "CFA International AB",
      "statusCode": 100,
      "statusText": "Aktivt",
      "roleCode": 5,
      "roleName": "Ledamot",
      "town": "LIDINGÖ"
    },
    {
      "companyId": "5569994600",
      "companyName": "KOMMANDITBOLAGET PORSEN 17",
      "statusCode": 100,
      "statusText": "Aktivt",
      "roleCode": 5,
      "roleName": "Ledamot",
      "town": "SJÖMARKEN"
    },
    {
      "companyId": "7696053631",
      "companyName": "Bostadsrättsföreningen Kamelian 4",
      "statusCode": 100,
      "statusText": "Aktivt",
      "roleCode": 5,
      "roleName": "Ledamot",
      "town": "STOCKHOLM"
    },
    {
      "companyId": "7696245120",
      "companyName": "Ek. för. Sydsvenska höglandets biokol",
      "statusCode": 100,
      "statusText": "Aktivt",
      "roleCode": 5,
      "roleName": "Ledamot",
      "town": "HULT"
    },
    {
      "companyId": "9696373076",
      "companyName": "RUMSDALS HÄSTSKJUTSAR O SERVICE HANDELSBOLAG",
      "statusCode": 100,
      "statusText": "Aktivt",
      "roleCode": 14,
      "roleName": "Bolagsman",
      "town": "UTÖ"
    }
  ]
}

Example: 196805029268

Request

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

Response

{
  "hitCount": 1,
  "personalNumber": "196805029268",
  "engagements": [
    {
      "companyId": "5565002465",
      "companyName": "Wilfast Högsbo Aktiebolag",
      "statusCode": 100,
      "statusText": "Aktivt",
      "roleCode": 10,
      "roleName": "Suppleant",
      "town": "GÖTEBORG"
    }
  ]
}

Example: 197904182396

Request

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

Response

{
  "hitCount": 3,
  "personalNumber": "197904182396",
  "engagements": [
    {
      "companyId": "5560572850",
      "companyName": "ACM 2001 AB",
      "statusCode": 141,
      "statusText": "Aktivt",
      "roleCode": 5,
      "roleName": "Ledamot",
      "town": "STOCKHOLM"
    },
    {
      "companyId": "5564866803",
      "companyName": "Aronfors Bygg och Teknik Aktiebolag",
      "statusCode": 100,
      "statusText": "Aktivt",
      "roleCode": 9,
      "roleName": "Revisorssuppleant",
      "town": "MUNKEDAL"
    },
    {
      "companyId": "5565002465",
      "companyName": "Wilfast Högsbo Aktiebolag",
      "statusCode": 100,
      "statusText": "Aktivt",
      "roleCode": 5,
      "roleName": "Ledamot",
      "town": "GÖTEBORG"
    }
  ]
}

Example: 194812161596

Request

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

Response

{
  "hitCount": 2,
  "personalNumber": "194812161596",
  "engagements": [
    {
      "companyId": "5567164818",
      "companyName": "Swedec AB",
      "statusCode": 100,
      "statusText": "Aktivt",
      "roleCode": 8,
      "roleName": "Revisor",
      "town": "TROLLHÄTTAN"
    },
    {
      "companyId": "7696053631",
      "companyName": "Bostadsrättsföreningen Kamelian 4",
      "statusCode": 100,
      "statusText": "Aktivt",
      "roleCode": 5,
      "roleName": "Ledamot",
      "town": "STOCKHOLM"
    }
  ]
}

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

SE | Company Board Members API

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 Company Board Members 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 | Board Members

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 | Board Members

Example: 9168937861

Request

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

Response

{
  "companyId": "9168937861",
  "changeDate": "2016-12-10",
  "boardMembers": [
    {
      "boardMemberCompanyId": "5563442945",
      "fullName": "Djurläkaren 6 Fastighets AB",
      "roleCode": "16",
      "roleName": "Komplementär",
      "fromDate": "2014-10-02"
    },
    {
      "boardMemberCompanyId": "5569487290",
      "fullName": "Björn och Guns Förvaltnings AB",
      "roleCode": "15",
      "roleName": "Kommanditdelägare",
      "fromDate": "2014-10-02"
    }
  ]
}

Example: 7696053631

Request

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

Response

{
  "companyId": "7696053631",
  "changeDate": "2016-12-10",
  "boardMembers": [
    {
      "boardMemberCompanyId": "3701308888",
      "personalNumber": "193701308888",
      "firstName": "Christina Birgitta Ulrika",
      "givenName": "Birgitta",
      "surName": "Efternamn3542",
      "roleCode": "5",
      "roleName": "Ledamot",
      "fromDate": "2012-03-20"
    },
    {
      "boardMemberCompanyId": "2907304766",
      "personalNumber": "192907304766",
      "firstName": "Helga Viktoria",
      "surName": "Efternamn2609",
      "roleCode": "5",
      "roleName": "Ledamot",
      "fromDate": "2012-03-20"
    },
    {
      "boardMemberCompanyId": "6805029268",
      "personalNumber": "196805029268",
      "firstName": "Petra",
      "surName": "Efternamn2401",
      "roleCode": "10",
      "roleName": "Suppleant",
      "fromDate": "2012-03-20"
    },
    {
      "boardMemberCompanyId": "4812161596",
      "personalNumber": "194812161596",
      "firstName": "Nils Uno",
      "givenName": "Uno",
      "surName": "Efternamn1433",
      "roleCode": "5",
      "roleName": "Ledamot",
      "fromDate": "2012-03-20"
    },
    {
      "boardMemberCompanyId": "7904182396",
      "personalNumber": "197904182396",
      "firstName": "Kuno",
      "surName": "Efternamn2993",
      "roleCode": "5",
      "roleName": "Ledamot",
      "fromDate": "2012-03-20"
    }
  ]
}

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"
    }
  ]
}

Example: 5567164818

Request

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

Response

{
  "companyId": "5567164818",
  "changeDate": "2016-12-10",
  "boardMembers": [
    {
      "boardMemberCompanyId": "3701308888",
      "personalNumber": "193701308888",
      "firstName": "Christina Birgitta Ulrika",
      "givenName": "Birgitta",
      "surName": "Efternamn3542",
      "roleCode": "10",
      "roleName": "Suppleant",
      "fromDate": "2008-06-05"
    },
    {
      "boardMemberCompanyId": "6805029268",
      "personalNumber": "196805029268",
      "firstName": "Petra",
      "surName": "Efternamn2401",
      "roleCode": "5",
      "roleName": "Ledamot",
      "fromDate": "2008-06-05"
    },
    {
      "boardMemberCompanyId": "4812161596",
      "personalNumber": "194812161596",
      "firstName": "Nils Uno",
      "givenName": "Uno",
      "surName": "Efternamn1433",
      "roleCode": "8",
      "roleName": "Revisor",
      "fromDate": "2011-07-12"
    },
    {
      "boardMemberCompanyId": "7904182396",
      "personalNumber": "197904182396",
      "firstName": "Kuno",
      "surName": "Efternamn2993",
      "roleCode": "9",
      "roleName": "Revisorssuppleant",
      "fromDate": "2011-07-12"
    }
  ]
}

Example: 5564866803

Request

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

Response

{
  "companyId": "5564866803",
  "changeDate": "2016-12-10",
  "boardMembers": [
    {
      "boardMemberCompanyId": "3701308888",
      "personalNumber": "193701308888",
      "firstName": "Christina Birgitta Ulrika",
      "givenName": "Birgitta",
      "surName": "Efternamn3542",
      "roleCode": "12",
      "roleName": "Verkställande direktör",
      "fromDate": "2003-11-01"
    },
    {
      "boardMemberCompanyId": "6805029268",
      "personalNumber": "196805029268",
      "firstName": "Petra",
      "surName": "Efternamn2401",
      "roleCode": "5",
      "roleName": "Ledamot",
      "fromDate": "2008-06-05"
    },
    {
      "boardMemberCompanyId": "4812161596",
      "personalNumber": "194812161596",
      "firstName": "Nils Uno",
      "givenName": "Uno",
      "surName": "Efternamn1433",
      "roleCode": "8",
      "roleName": "Revisor",
      "fromDate": "2011-07-12"
    },
    {
      "boardMemberCompanyId": "7904182396",
      "personalNumber": "197904182396",
      "firstName": "Kuno",
      "surName": "Efternamn2993",
      "roleCode": "9",
      "roleName": "Revisorssuppleant",
      "fromDate": "2011-07-12"
    }
  ]
}

Example: 5569994600

Request

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

Response

{
  "companyId": "5569994600",
  "changeDate": "2016-12-10",
  "boardMembers": [
    {
      "boardMemberCompanyId": "3701308888",
      "personalNumber": "193701308888",
      "firstName": "Christina Birgitta Ulrika",
      "givenName": "Birgitta",
      "surName": "Efternamn3542",
      "roleCode": "5",
      "roleName": "Ledamot",
      "fromDate": "2012-03-20"
    },
    {
      "boardMemberCompanyId": "2907304766",
      "personalNumber": "192907304766",
      "firstName": "Helga Viktoria",
      "surName": "Efternamn2609",
      "roleCode": "5",
      "roleName": "Ledamot",
      "fromDate": "2012-03-20"
    },
    {
      "boardMemberCompanyId": "6805029268",
      "personalNumber": "196805029268",
      "firstName": "Petra",
      "surName": "Efternamn2401",
      "roleCode": "8",
      "roleName": "Revisor",
      "fromDate": "2012-03-20"
    }
  ]
}

Example: 5590506506

Request

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

Response

{
  "companyId": "5590506506",
  "changeDate": "2016-12-10",
  "boardMembers": [
    {
      "boardMemberCompanyId": "9111029196",
      "personalNumber": "199111029196",
      "firstName": "Martin Oskar",
      "givenName": "Oskar",
      "surName": "Efternamn3227",
      "roleCode": "6",
      "roleName": "Likvidator",
      "fromDate": "2016-11-24"
    }
  ]
}

Example: 5560572850

Request

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

Response

{
  "companyId": "5560572850",
  "changeDate": "2016-12-10",
  "boardMembers": [
    {
      "boardMemberCompanyId": "4812161596",
      "personalNumber": "194812161596",
      "firstName": "Nils Uno",
      "givenName": "Uno",
      "surName": "Efternamn1433",
      "roleCode": "5",
      "roleName": "Ledamot",
      "fromDate": "2012-03-20"
    },
    {
      "boardMemberCompanyId": "7904182396",
      "personalNumber": "197904182396",
      "firstName": "Kuno",
      "surName": "Efternamn2993",
      "roleCode": "5",
      "roleName": "Ledamot",
      "fromDate": "2012-03-20"
    },
    {
      "boardMemberCompanyId": "3701308888",
      "personalNumber": "193701308888",
      "firstName": "Christina Birgitta Ulrika",
      "givenName": "Birgitta",
      "surName": "Efternamn3542",
      "roleCode": "18",
      "roleName": "Ordförande",
      "fromDate": "2015-09-16"
    },
    {
      "boardMemberCompanyId": "5560535873",
      "fullName": "Ernst & Young Aktiebolag",
      "roleCode": "8",
      "roleName": "Revisor",
      "fromDate": "2008-05-29"
    },
    {
      "boardMemberCompanyId": "4812161596",
      "personalNumber": "194812161596",
      "firstName": "Nils Uno",
      "givenName": "Uno",
      "surName": "Efternamn1433",
      "roleCode": "21",
      "roleName": "Huvudansvarig revisor",
      "fromDate": "2015-06-18"
    },
    {
      "boardMemberCompanyId": "6805029268",
      "personalNumber": "196805029268",
      "firstName": "Petra",
      "surName": "Efternamn2401",
      "roleCode": "5",
      "roleName": "Ledamot",
      "fromDate": "2015-09-16"
    }
  ]
}

Example: 5569030264

Request

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

Response

{
  "companyId": "5569030264",
  "changeDate": "2016-12-10",
  "boardMembers": [
    {
      "boardMemberCompanyId": "7904182396",
      "personalNumber": "197904182396",
      "firstName": "Kuno",
      "surName": "Efternamn2993",
      "roleCode": "6",
      "roleName": "Likvidator",
      "fromDate": "2015-12-16"
    }
  ]
}

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

SE | Company Right To Sign API

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 Company Right To Sign 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
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 | Right To Sign

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.

Company ID Personal identity number
5565002465 19290730476
5560572850 193701308888

SE | Company Signing Combinations API

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 Company Engagement 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
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 | Signing Combinations

Example: 9168937861

Request

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

Response

{
  "companyId": "9168937861",
  "changeDate": "2018-06-10",
  "coverage": "complete",
  "adminSign": null,
  "combinations": [
    [
      {
        "name": "Djurläkaren 6 Fastighets AB",
        "positions": [
          {
            "roleCode": 16,
            "roleName": "Komplementär"
          }
        ],
        "personalNumber": "D5563442945",
        "anomalies": [
          {
            "anomalyCode": 1,
            "anomalyDescription": "Company identifier instead of personal identifier"
          }
        ]
      }
    ]
  ]
}

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: 5567164818

Request

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

Response

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

Example: 5564866803

Request

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

Response

{
  "companyId": "5564866803",
  "changeDate": "2018-06-10",
  "coverage": "complete",
  "adminSign": null,
  "combinations": [
    [
      {
        "name": "Efternamn2401, Petra",
        "positions": [
          {
            "roleCode": 5,
            "roleName": "Ledamot"
          }
        ],
        "personalNumber": "196805029268",
        "anomalies":null
      }
    ],
    [
      {
        "name": "Efternamn3542, Birgitta",
        "positions": [
          {
            "roleCode": 10,
            "roleName": "Suppleant"
          },
          {
            "roleCode": 12,
            "roleName": "Verkställande direktör"
          }
        ],
        "personalNumber": "193701308888",
        "anomalies":null
      }
    ]
  ]
}

Example: 5569994600

Request

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

Response

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

Example: 5590506506

Request

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

Response

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

>> Example: 5560572850

> Request

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

Response

{
  "companyId": "5560572850",
  "changeDate": "2018-06-10",
  "coverage": "complete",
  "adminSign": null,
  "combinations": [
    [
      {
        "name": "Efternamn1433, Nils Uno",
        "positions": [
          {
            "roleCode": 5,
            "roleName": "Ledamot"
          }
        ],
        "personalNumber": "194812161596",
        "anomalies":null
      },
      {
        "name": "Efternamn2993, Kuno",
        "positions": [
          {
            "roleCode": 18,
            "roleName": "Ordförande"
          },
          {
            "roleCode": 5,
            "roleName": "Ledamot"
          }
        ],
        "personalNumber": "197904182396",
        "anomalies":null
      }
    ],
    [
      {
        "name": "Efternamn1433, Nils Uno",
        "positions": [
          {
            "roleCode": 5,
            "roleName": "Ledamot"
          }
        ],
        "personalNumber": "194812161596",
        "anomalies":null
      },
      {
        "name": "Efternamn1433, Nils Uno",
        "positions": [
          {
            "roleCode": 10,
            "roleName": "Suppleant"
          }
        ],
        "personalNumber": "194812161596",
        "anomalies":null
      }
    ],
    [
      {
        "name": "Efternamn1433, Nils Uno",
        "positions": [
          {
            "roleCode": 5,
            "roleName": "Ledamot"
          }
        ],
        "personalNumber": "194812161596"
      },
      {
        "name": "Efternamn3227, Martin Oskar",
        "positions": [
          {
            "roleCode": 2,
            "roleName": "Extern firmatecknare"
          }
        ],
        "personalNumber": "199111029196",
        "anomalies":null
      }
    ],
    [
      {
        "name": "Efternamn2993, Kuno",
        "positions": [
          {
            "roleCode": 18,
            "roleName": "Ordförande"
          },
          {
            "roleCode": 5,
            "roleName": "Ledamot"
          }
        ],
        "personalNumber": "197904182396",
        "anomalies":null
      },
      {
        "name": "Efternamn1433, Nils Uno",
        "positions": [
          {
            "roleCode": 10,
            "roleName": "Suppleant"
          }
        ],
        "personalNumber": "194812161596",
        "anomalies":null
      }
    ],
    [
      {
        "name": "Efternamn2993, Kuno",
        "positions": [
          {
            "roleCode": 18,
            "roleName": "Ordförande"
          },
          {
            "roleCode": 5,
            "roleName": "Ledamot"
          }
        ],
        "personalNumber": "197904182396",
        "anomalies":null
      },
      {
        "name": "Efternamn3227, Martin Oskar",
        "positions": [
          {
            "roleCode": 2,
            "roleName": "Extern firmatecknare"
          }
        ],
        "personalNumber": "199111029196",
        "anomalies":null
      }
    ],
    [
      {
        "name": "Efternamn3227, Martin Oskar",
        "positions": [
          {
            "roleCode": 2,
            "roleName": "Extern firmatecknare"
          }
        ],
        "personalNumber": "199111029196",
        "anomalies":null
      },
      {
        "name": "Efternamn1433, Nils Uno",
        "positions": [
          {
            "roleCode": 10,
            "roleName": "Suppleant"
          }
        ],
        "personalNumber": "194812161596",
        "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

SE | Company Signatory API

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 Company Board Members 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
companySignatory
string, optional
Signatory for the company

Organization Numbers for Test | Signatory

Example: 9168937861

Request

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

Response

{
  "changeDate": "2016-12-10",
  "companyId": "9168937861",
  "companySignatory": "Firman tecknas ensam av >komplementären"
}

Example: 7696053631

Request

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

Response

{
  "changeDate": "2016-12-10",
  "companyId": "7696053631",
  "companySignatory": "Firman tecknas av styrelsen Firman tecknas två i förening av >ledamöterna"
}

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"
}

Example: 5567164818

Request

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

Response

{
  "changeDate": "2016-12-10",
  "companyId": "5567164818",
  "companySignatory": "Firman tecknas av styrelsen"
}

Example: 5564866803

Request

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

Response

{
  "changeDate": "2016-12-10",
  "companyId": "5564866803",
  "companySignatory": "Firman tecknas var för sig av  >Aronsson, Jan Håkan  >Forslund, Nils-Eric"
}

Example: 5569994600

Request

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

Response

{
  "changeDate": "2016-12-10",
  "companyId": "5569994600",
  "companySignatory": "Firman tecknas av styrelsen"
}

Example: 5590506506

Request

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

Response

{
  "changeDate": "2016-12-10",
  "companyId": "5590506506",
  "companySignatory": "Firman tecknas ensam av >likvidatorn"
}

Example: 5560572850

Request

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

Response

{
  "changeDate": "2016-12-10",
  "companyId": "5560572850",
  "companySignatory": "Firman tecknas av styrelsen Firman tecknas två i förening av >ledamöterna"
}

Example: 5569030264

Request

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

Response

{
  "changeDate": "2016-12-10",
  "companyId": "5569030264",
  "companySignatory": "Firman tecknas ensam av >likvidatorn Registrerad kvalificerad revisor saknas."
}

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

SE | Company Event API

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 Company Event 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 ,
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

Organization Numbers for Test | Events

Request example: 916893-7861

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

Response example:

 {
  "responseInfo": {
    "requestCount": 1,
    "hitCount": 1,
    "noMatchIds": []
  },
  "responses": [
    {
      "companyId": "9168937861",
      "code": "ADRC",
      "changeDate": "20180106",
      "dataSet": [
        "company-overview"
      ]
    }
  ]
}

Request example: 556500-2465

curl -X POST --header 'Content-Type: application/json' \
--header 'Accept: application/json' --header 'Authorization: Bearer {ACCESS TOKEN}' \ 
   "requests": [ \ 
     { \ 
       "companyId": "5565002465", \ 
       "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"
      ]
    }
  ]
}

Request example: 556057-2850

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

Response example:

{
  "responseInfo": {
    "requestCount": 1,
    "hitCount": 5,
    "noMatchIds": []
  },
  "responses": [
    {
      "companyId": "5560572850",
      "code": "ANAN",
      "changeDate": "20180214",
      "dataSet": [
        "company-economy-overview"
      ]
    },
    {
      "companyId": "5560572850",
      "code": "ASIC",
      "changeDate": "20180908",
      "dataSet": [
        "company-signatory",
        "company-board-members"
      ]
    },
    {
      "companyId": "5560572850",
      "code": "REPC",
      "changeDate": "20180210",
      "dataSet": [
        "company-signatory",
        "company-board-members"
      ]
    },
    {
      "companyId": "5560572850",
      "code": "REPC",
      "changeDate": "20180908",
      "dataSet": [
        "company-signatory",
        "company-board-members"
      ]
    },
    {
      "companyId": "5560572850",
      "code": "ASIC",
      "changeDate": "20180210",
      "dataSet": [
        "company-signatory",
        "company-board-members"
      ]
    }
  ]
}

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"
      ]
    }
  ]
  }

Request example: 556903-0264

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

Response example:

  {
  "responseInfo": {
    "requestCount": 1,
    "hitCount": 1,
    "noMatchIds": []
  },
  "responses": [
    {
      "companyId": "5569030264",
      "code": "STAC",
      "changeDate": "20180220",
      "dataSet": [
        "company-overview"
      ]
    }
  ]
}

Request example: 769605-3631

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

Response example:

{
  "responseInfo": {
    "requestCount": 1,
    "hitCount": 2,
    "noMatchIds": []
  },
  "responses": [
    {
      "companyId": "7696053631",
      "code": "ASIC",
      "changeDate": "2018-06-20",
      "dataSet": [
        "company-signatory",
        "company-board-members"
      ]
    },
    {
      "companyId": "7696053631",
      "code": "REPC",
      "changeDate": "2018-06-20",
      "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

NO | Person API

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 Person API data description | No

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)
birthCommuneCodeOrCountryCode
(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)
moveFromForeignCountryRegistrationDate
(string, optional)
moveFromForeignCountryDate
(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 which you scan and email us at support@roaring.io. Once this is done, we take over and help you with the application process.

Personal Numbers for Test | NO

Example: Death | 31120000767 | Johansen | Bror

{
  "posts": [
    {
      "actualPersonalNumber": true,
      "personalNumber": "31120000767",
      "status": {
        "registrationDate": "2006-06-06",
        "code": 5,
        "formatted": "Death"
      },
      "hasHistory": false,
      "secrecyMarked": false,
      "details": [
        {
          "birthDate": "1900-12-31",
          "firstName": "BROR",
          "surName": "JOHANSEN",
          "middleName": "PSA",
          "fullName": "JOHANSEN BROR PSA",
          "gender": "M"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "communeCode": "0019",
            "communeName": "REFKOM2"
          }
        ],
        "specialAddresses": [
          {
            "code": 0,
            "formatted": "Ordinary resident"
          }
        ]
      },
      "citizenship": [
        {
          "code": "000",
          "country": "NORSK"
        }
      ]
    }
  ],
  "source": "Det Sentrale Folkeregister (DSF)"
}

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: Resident | 22100250539 | Otterli | Roy 

{
  "posts": [
    {
      "actualPersonalNumber": true,
      "personalNumber": "22100250539",
      "status": {
        "code": 1,
        "formatted": "Resident"
      },
      "hasHistory": false,
      "secrecyMarked": false,
      "details": [
        {
          "birthDate": "2002-10-22",
          "firstName": "ROY",
          "surName": "OTTERLI",
          "middleName": "WEB",
          "fullName": "OTTERLI ROY WEB",
          "gender": "M"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "registrationDate": "2003-03-03",
            "deliveryAddress1": "BOKS 6300, ETTERSTAD",
            "postalNumber": "0603",
            "city": "OSLO",
            "communeCode": "0020",
            "communeName": "REFKOM3",
            "addressType": {
              "code": 1,
              "formatted": "Property",
              "property": {
                "holdingNumber": "00020",
                "subHoldingNumber": "0020"
              }
            },
            "moveToDate": "2003-03-03"
          }
        ],
        "previousAddresses": [
          {
            "moveFromRegistrationDate": "2003-03-03",
            "moveFromCommuneCode": "0019",
            "moveFromCommuneName": "REFKOM2",
            "moveFromForeignCountry": "ISLAND",
            "moveFromForeignCountryCode": 105
          }
        ],
        "specialAddresses": [
          {
            "code": 0,
            "formatted": "Ordinary resident"
          }
        ]
      },
      "citizenship": [
        {
          "code": "000",
          "country": "NORSK"
        }
      ]
    }
  ],
  "source": "Det Sentrale Folkeregister (DSF)"
}

Example: Resident | 19066600109 | Os | Ove 

{
  "posts": [
    {
      "actualPersonalNumber": true,
      "personalNumber": "19066600109",
      "status": {
        "code": 1,
        "formatted": "Resident"
      },
      "hasHistory": false,
      "secrecyMarked": false,
      "details": [
        {
          "birthDate": "1966-06-19",
          "firstName": "OVE",
          "surName": "OS",
          "middleName": "FOS",
          "fullName": "OS OVE FOS",
          "gender": "M"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "registrationDate": "1992-01-01",
            "deliveryAddress1": "BOKS 6300, ETTERSTAD",
            "postalNumber": "0603",
            "city": "OSLO",
            "communeCode": "0018",
            "communeName": "REFKOM1",
            "addressType": {
              "code": 1,
              "formatted": "Property",
              "property": {
                "holdingNumber": "00019",
                "subHoldingNumber": "0018"
              }
            },
            "moveToDate": "1992-01-01"
          }
        ],
        "specialAddresses": [
          {
            "code": 0,
            "formatted": "Ordinary resident"
          }
        ]
      },
      "citizenship": [
        {
          "code": "000",
          "country": "NORSK"
        }
      ]
    }
  ],
  "source": "Det Sentrale Folkeregister (DSF)"
}

Example: Resident | 19066600370 | Muren | Magne

{
  "posts": [
    {
      "actualPersonalNumber": true,
      "personalNumber": "19066600370",
      "status": {
        "code": 1,
        "formatted": "Resident"
      },
      "hasHistory": false,
      "secrecyMarked": false,
      "details": [
        {
          "birthDate": "1966-06-19",
          "firstName": "MAGNE",
          "surName": "MUREN",
          "middleName": "SVALBARD",
          "fullName": "MUREN MAGNE SVALBARD",
          "gender": "M"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "registrationDate": "1998-03-03",
            "deliveryAddress1": "ETTERSTAD",
            "postalNumber": "0603",
            "city": "OSLO",
            "communeCode": "0018",
            "communeName": "REFKOM1",
            "addressType": {
              "code": 1,
              "formatted": "Property",
              "property": {
                "holdingNumber": "00018",
                "subHoldingNumber": "0018"
              }
            },
            "moveToDate": "1998-03-03"
          }
        ],
        "specialAddresses": [
          {
            "code": 3,
            "formatted": "Svalbard"
          }
        ]
      },
      "citizenship": [
        {
          "code": "000",
          "country": "NORSK"
        }
      ]
    }
  ],
  "source": "Det Sentrale Folkeregister (DSF)"
}

Example: Expat | 17056800344 | Fallet | Henrik

{
  "posts": [
    {
      "actualPersonalNumber": true,
      "personalNumber": "17056800344",
      "status": {
        "code": 3,
        "formatted": "Expat"
      },
      "hasHistory": false,
      "secrecyMarked": false,
      "details": [
        {
          "birthDate": "1968-05-17",
          "firstName": "HENRIK",
          "surName": "FALLET",
          "middleName": "FOS",
          "fullName": "FALLET HENRIK FOS",
          "gender": "M"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "communeCode": "0018",
            "communeName": "REFKOM1"
          }
        ],
        "foreignAddresses": [
          {
            "country": "SVERIGE",
            "countryCode": "106"
          }
        ],
        "specialAddresses": [
          {
            "code": 0,
            "formatted": "Ordinary resident"
          }
        ]
      },
      "citizenship": [
        {
          "code": "000",
          "country": "NORSK"
        }
      ]
    }
  ],
  "source": "Det Sentrale Folkeregister (DSF)"
}

Example: Resident | 20067900562 | Gjestvang | Eirik

{
  "posts": [
    {
      "actualPersonalNumber": true,
      "personalNumber": "20067900562",
      "status": {
        "code": 1,
        "formatted": "Resident"
      },
      "hasHistory": false,
      "secrecyMarked": false,
      "details": [
        {
          "birthDate": "1979-06-20",
          "firstName": "EIRIK",
          "surName": "GJESTVANG",
          "middleName": "WEB",
          "fullName": "GJESTVANG EIRIK WEB",
          "gender": "M"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "registrationDate": "2001-01-01",
            "deliveryAddress1": "BOKS 6300, ETTERSTAD",
            "postalNumber": "0603",
            "city": "OSLO",
            "communeCode": "0020",
            "communeName": "REFKOM3",
            "addressType": {
              "code": 1,
              "formatted": "Property",
              "property": {
                "holdingNumber": "00020",
                "subHoldingNumber": "0020"
              }
            },
            "moveToDate": "2001-01-01"
          }
        ],
        "specialAddresses": [
          {
            "code": 0,
            "formatted": "Ordinary resident"
          }
        ]
      },
      "citizenship": [
        {
          "code": "000",
          "country": "NORSK"
        }
      ]
    }
  ],
  "source": "Det Sentrale Folkeregister (DSF)"
}

Example: Disappeared | 13084000374 | Rud | Svein

{
  "posts": [
    {
      "actualPersonalNumber": true,
      "personalNumber": "13084000374",
      "status": {
        "code": 4,
        "formatted": "Disappeared"
      },
      "hasHistory": false,
      "secrecyMarked": false,
      "details": [
        {
          "birthDate": "1940-08-13",
          "firstName": "SVEIN",
          "surName": "RUD",
          "middleName": "PSA",
          "fullName": "RUD SVEIN PSA",
          "gender": "M"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "communeCode": "0019",
            "communeName": "REFKOM2"
          }
        ],
        "previousAddresses": [
          {
            "moveFromRegistrationDate": "1998-09-21",
            "moveFromCommuneCode": "0014",
            "moveFromCommuneName": "",
            "moveFromForeignCountry": "FINLAND",
            "moveFromForeignCountryCode": 103
          }
        ],
        "specialAddresses": [
          {
            "code": 0,
            "formatted": "Ordinary resident"
          }
        ]
      },
      "citizenship": [
        {
          "code": "000",
          "country": "NORSK"
        }
      ]
    }
  ],
  "source": "Det Sentrale Folkeregister (DSF)"
}

Example: Disappeared | 01017700568 | Nilsen | Kristian

{
  "posts": [
    {
      "actualPersonalNumber": true,
      "personalNumber": "01017700568",
      "status": {
        "code": 4,
        "formatted": "Disappeared"
      },
      "hasHistory": false,
      "secrecyMarked": false,
      "details": [
        {
          "birthDate": "1977-01-01",
          "firstName": "KRISTIAN",
          "surName": "NILSEN",
          "middleName": "PSA",
          "fullName": "NILSEN KRISTIAN PSA",
          "gender": "M"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "communeCode": "0019",
            "communeName": "REFKOM2"
          }
        ],
        "previousAddresses": [
          {
            "moveFromRegistrationDate": "1995-10-01",
            "moveFromCommuneCode": "0018",
            "moveFromCommuneName": "REFKOM1",
            "moveFromForeignCountry": "FINLAND",
            "moveFromForeignCountryCode": 103
          }
        ],
        "specialAddresses": [
          {
            "code": 0,
            "formatted": "Ordinary resident"
          }
        ]
      },
      "citizenship": [
        {
          "code": "000",
          "country": "NORSK"
        }
      ]
    }
  ],
  "source": "Det Sentrale Folkeregister (DSF)"
}

Example: Canceled Access | 07087000405 | Hageland | Inger

{
  "posts": [
    {
      "actualPersonalNumber": true,
      "personalNumber": "07087000405",
      "status": {
        "code": 8,
        "formatted": "Canceled Access"
      },
      "hasHistory": false,
      "secrecyMarked": false,
      "details": [
        {
          "birthDate": "1970-08-07",
          "firstName": "INGER",
          "surName": "HAGELAND",
          "middleName": "PSA",
          "fullName": "HAGELAND INGER PSA",
          "gender": "F"
        }
      ],
      "address": {
        "nationalRegistrationAddress": [
          {
            "communeCode": "",
            "communeName": ""
          }
        ],
        "previousAddresses": [
          {
            "moveFromCommuneCode": "",
            "moveFromCommuneName": "",
            "moveFromForeignCountry": "",
            "country": "SVERIGE",
            "countryCode": "106"
          }
        ],
        "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

NO | Company Simple Search API

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

Detailed SimpleSearch 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 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 for simple search no

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

Search parameters for Test | Simple Search no

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

NO | Company Overview API

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 Company NO 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
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 | Company no-Overview

Example: Underavdeling | 971697555

{
  "numberCompanyUnits": "0",
  "statusCode": "A",
  "registeredTown": "KONGSBERG",
  "registeredZipCode": "3611",
  "phoneNumber": "32732118",
  "startDateVat": null,
  "topDirectorFunction": null,
  "industryText": "Butikkhandel med klær",
  "statusTextDetailed": "Active",
  "coAddress": null,
  "zipCode": "3606",
  "vatYN": null,
  "industryTextEng": "Retail sale of clothing in specialised stores",
  "county": null,
  "industryCode": "47.710",
  "registeredCommuneCode": "0604",
  "communeCode": "0604",
  "statusTextHigh": "Active",
  "changeDate": "2017-10-14",
  "companyName": "JUNIORS AS",
  "statusDateFrom": null,
  "vatReg": null,
  "legalGroupCode": "BEDR",
  "address": "Postboks 784",
  "legalGroupTextEng": "Unit",
  "registeredCommune": "Kongsberg",
  "commune": "Kongsberg",
  "companyRegistrationDate": "19950222",
  "town": "KONGSBERG",
  "registeredCoAddress": null,
  "companyId": "971697555",
  "topDirectorName": null,
  "legalGroupText": "Underavdeling",
  "registeredAddress": "Karsches gate 3",
  "companyDeregistrationDate": null,
  "faxNumber": "32724459"
}

Example: Enkeltpersonsforetak | 919434104

{
  "numberCompanyUnits": "1",
  "statusCode": "A",
  "registeredTown": "HOVLAND",
  "registeredZipCode": "5773",
  "phoneNumber": null,
  "startDateVat": "2017-09",
  "topDirectorFunction": null,
  "industryText": "Dyrking av kjernefrukter og steinfrukter",
  "statusTextDetailed": "Active",
  "coAddress": null,
  "zipCode": null,
  "vatYN": "no",
  "industryTextEng": "Growing of pome fruits and stone fruits",
  "county": null,
  "industryCode": "01.240",
  "registeredCommuneCode": "1231",
  "communeCode": null,
  "statusTextHigh": "Active",
  "changeDate": "2017-10-14",
  "companyName": "TROND STEINE FRUKT OG KULTUR",
  "statusDateFrom": null,
  "vatReg": "0",
  "legalGroupCode": "ENK",
  "address": null,
  "legalGroupTextEng": "Sole proprietorship",
  "registeredCommune": "Ullensvang",
  "commune": null,
  "companyRegistrationDate": "20170818",
  "town": null,
  "registeredCoAddress": null,
  "companyId": "919434104",
  "topDirectorName": null,
  "legalGroupText": "Enkeltpersonsforetak",
  "registeredAddress": "Ullensvangvegen 1643",
  "companyDeregistrationDate": null,
  "faxNumber": null
}

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"
}

Example: Aksjeselskap | 810392312

{
  "numberCompanyUnits": "1",
  "statusCode": "A",
  "registeredTown": "OSLO",
  "registeredZipCode": "0668",
  "phoneNumber": "23142610",
  "startDateVat": "2016-03",
  "topDirectorFunction": "Daglig leder/administrerende direktør",
  "industryText": "Sortering og bearbeiding av avfall for materialgjenvinning",
  "statusTextDetailed": "Active",
  "coAddress": null,
  "zipCode": "0614",
  "vatYN": "yes",
  "industryTextEng": "Recovering of sorted materials",
  "county": null,
  "industryCode": "38.320",
  "registeredCommuneCode": "0301",
  "communeCode": "0301",
  "statusTextHigh": "Active",
  "changeDate": "2017-10-14",
  "companyName": "METALLCO AS",
  "statusDateFrom": null,
  "vatReg": "1",
  "legalGroupCode": "AS",
  "address": "Postboks 15 ALNABRU",
  "legalGroupTextEng": "Limited company",
  "registeredCommune": "Oslo",
  "commune": "Oslo",
  "companyRegistrationDate": "19950219",
  "town": "OSLO",
  "registeredCoAddress": null,
  "companyId": "810392312",
  "topDirectorName": "Feinberg, Laurie Fredrik",
  "legalGroupText": "Aksjeselskap",
  "registeredAddress": "Strømsveien 287",
  "companyDeregistrationDate": null,
  "faxNumber": "23142611"
}

Example: Kirkelig Fellesråd | 987569166

{
  "numberCompanyUnits": "1",
  "statusCode": "A",
  "registeredTown": "ÅLESUND",
  "registeredZipCode": "6007",
  "phoneNumber": "70114566",
  "startDateVat": "2017-10",
  "topDirectorFunction": "Daglig leder/administrerende direktør",
  "industryText": "Religiøse organisasjoner",
  "statusTextDetailed": "Active",
  "coAddress": null,
  "zipCode": null,
  "vatYN": "no",
  "industryTextEng": "Activities of religious organisations",
  "county": null,
  "industryCode": "94.910",
  "registeredCommuneCode": "1504",
  "communeCode": null,
  "statusTextHigh": "Active",
  "changeDate": "2017-10-14",
  "companyName": "DØVES MENIGHET ÅLESUND",
  "statusDateFrom": null,
  "vatReg": "0",
  "legalGroupCode": "KIRK",
  "address": null,
  "legalGroupTextEng": "Council of Churches",
  "registeredCommune": "Ålesund",
  "commune": null,
  "companyRegistrationDate": "20041229",
  "town": null,
  "registeredCoAddress": null,
  "companyId": "987569166",
  "topDirectorName": "Sværen, Guri Kaland",
  "legalGroupText": "Kirkelig Fellesråd",
  "registeredAddress": "Borgundvegen 124",
  "companyDeregistrationDate": null,
  "faxNumber": "70114551"
}

Example: Administrativ Enhet Offentlig Sektor | 990492263

{
  "numberCompanyUnits": "0",
  "statusCode": "A",
  "registeredTown": "MYRE",
  "registeredZipCode": "8430",
  "phoneNumber": null,
  "startDateVat": "2017-10",
  "topDirectorFunction": null,
  "industryText": null,
  "statusTextDetailed": "Active",
  "coAddress": null,
  "zipCode": null,
  "vatYN": "no",
  "industryTextEng": null,
  "county": null,
  "industryCode": "00.000",
  "registeredCommuneCode": "1868",
  "communeCode": null,
  "statusTextHigh": "Active",
  "changeDate": "2017-10-14",
  "companyName": "SKATTEOPPKREVEREN I ØKSNES KOMMUNE",
  "statusDateFrom": null,
  "vatReg": "0",
  "legalGroupCode": "ADOS",
  "address": null,
  "legalGroupTextEng": "ADOS",
  "registeredCommune": "Øksnes",
  "commune": null,
  "companyRegistrationDate": "20070319",
  "town": null,
  "registeredCoAddress": null,
  "companyId": "990492263",
  "topDirectorName": null,
  "legalGroupText": "Administrativ Enhet Offentlig Sektor",
  "registeredAddress": "Storgata 27",
  "companyDeregistrationDate": null,
  "faxNumber": null
}

Example: Selskap Med Begrenset Ansvar | 970232222

{
  "numberCompanyUnits": "0",
  "statusCode": "A",
  "registeredTown": "SANDVIKA",
  "registeredZipCode": "1300",
  "phoneNumber": null,
  "startDateVat": "2017-10",
  "topDirectorFunction": null,
  "industryText": "Reklamebyråer",
  "statusTextDetailed": "Active",
  "coAddress": null,
  "zipCode": "1300",
  "vatYN": "no",
  "industryTextEng": "Advertising agencies",
  "county": null,
  "industryCode": "73.110",
  "registeredCommuneCode": "0219",
  "communeCode": "0219",
  "statusTextHigh": "Active",
  "changeDate": "2017-10-14",
  "companyName": "HELGERUDGÅRDENS SENTERFOREN A/L",
  "statusDateFrom": null,
  "vatReg": "0",
  "legalGroupCode": "BA",
  "address": "RINGERIKSV 6",
  "legalGroupTextEng": "Company with limited liability",
  "registeredCommune": "Bærum",
  "commune": "Bærum",
  "companyRegistrationDate": "19950312",
  "town": "SANDVIKA",
  "registeredCoAddress": null,
  "companyId": "970232222",
  "topDirectorName": null,
  "legalGroupText": "Selskap Med Begrenset Ansvar",
  "registeredAddress": "HELGERUDGÅRDEN",
  "companyDeregistrationDate": null,
  "faxNumber": null
}

Example: Forening/Lag/Innretning | 811556912

{
  "numberCompanyUnits": "0",
  "statusCode": "A",
  "registeredTown": "LEVANGER",
  "registeredZipCode": "7605",
  "phoneNumber": null,
  "startDateVat": "2017-10",
  "topDirectorFunction": "Styreleder",
  "industryText": "Aktiviteter i andre interesseorganisasjoner ikke nevnt annet sted",
  "statusTextDetailed": "Active",
  "coAddress": null,
  "zipCode": null,
  "vatYN": "no",
  "industryTextEng": "Activities of other membership organisations",
  "county": null,
  "industryCode": "94.991",
  "registeredCommuneCode": "1719",
  "communeCode": null,
  "statusTextHigh": "Active",
  "changeDate": "2017-10-14",
  "companyName": "BØRØYA HYTTEFORENING",
  "statusDateFrom": null,
  "vatReg": "0",
  "legalGroupCode": "FLI",
  "address": null,
  "legalGroupTextEng": "Association/club/organisation",
  "registeredCommune": "Levanger",
  "commune": null,
  "companyRegistrationDate": "20130325",
  "town": null,
  "registeredCoAddress": "c/o Annar J Johansen Skogheimvegen 14",
  "companyId": "811556912",
  "topDirectorName": "Johansen, Annar Julius",
  "legalGroupText": "Forening/Lag/Innretning",
  "registeredAddress": null,
  "companyDeregistrationDate": null,
  "faxNumber": null
}

Example: Annet Foretak Iflg. Særsk. Lov | 818711832

{
  "numberCompanyUnits": "0",
  "statusCode": "A",
  "registeredTown": "BODØ",
  "registeredZipCode": "8006",
  "phoneNumber": "75549950",
  "startDateVat": "2017-10",
  "topDirectorFunction": "Daglig leder/administrerende direktør",
  "industryText": "Ambulansetjenester",
  "statusTextDetailed": "Active",
  "coAddress": null,
  "zipCode": "8001",
  "vatYN": "no",
  "industryTextEng": "Ambulance services",
  "county": null,
  "industryCode": "86.907",
  "registeredCommuneCode": "1804",
  "communeCode": "1804",
  "statusTextHigh": "Active",
  "changeDate": "2017-10-14",
  "companyName": "LUFTAMBULANSETJENESTEN HF",
  "statusDateFrom": null,
  "vatReg": "0",
  "legalGroupCode": "SÆR",
  "address": "Postboks 235",
  "legalGroupTextEng": "Other business enterprise in accordance with special legislation",
  "registeredCommune": "Bodø",
  "commune": "Bodø",
  "companyRegistrationDate": "20170508",
  "town": "BODØ",
  "registeredCoAddress": null,
  "companyId": "818711832",
  "topDirectorName": "Juell, Øyvind",
  "legalGroupText": "Annet Foretak Iflg. Særsk. Lov",
  "registeredAddress": "Torvgata 2",
  "companyDeregistrationDate": null,
  "faxNumber": null
}

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

NO | Company Signing Combinations API

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 Company Signing Combinations NO 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
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 | Signing Combinations NO

Example: 971697555

Request

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

Response

{
  "message": "InvalidAttributes",
  "error": "This companyId is for a sub-department, please use the main companyId"
}

Example: 919434104

Request

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

Response

{
  "companyId": "919434104",
  "changeDate": "2018-10-12",
  "coverage": "Complete",
  "combinations": [
    [
      {
        "name": "Bror Johansen",
        "positions": [
          {
            "roleCode": "INNH",
            "roleName": "Eier"
          }
        ],
        "personalNumber": "31120000767",
        "anomalies": null
      }
    ]
  ],
  "prokura": []
}

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": []
}

Example: 810392312

Request

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

Response

{
  "companyId": "810392312",
  "changeDate": "2018-11-05",
  "coverage": "Complete",
  "combinations": [
    [
      {
        "name": "Stian Kavli",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "20119800324",
        "anomalies": null
      },
      {
        "name": "Roy Otterli",
        "positions": [
          {
            "roleCode": "LEDE",
            "roleName": "Styreleder"
          }
        ],
        "personalNumber": "22100250539",
        "anomalies": null
      }
    ],
    [
      {
        "name": "Bror Johansen",
        "positions": [
          {
            "roleCode": "DAGL",
            "roleName": "Daglig leder/administrerende direktør"
          },
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "31120000767",
        "anomalies": null
      },
      {
        "name": "Roy Otterli",
        "positions": [
          {
            "roleCode": "LEDE",
            "roleName": "Styreleder"
          }
        ],
        "personalNumber": "22100250539",
        "anomalies": null
      }
    ],
    [
      {
        "name": "Ove Os",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "19066600109",
        "anomalies": null
      },
      {
        "name": "Roy Otterli",
        "positions": [
          {
            "roleCode": "LEDE",
            "roleName": "Styreleder"
          }
        ],
        "personalNumber": "22100250539",
        "anomalies": null
      }
    ],
    [
      {
        "name": "Magne Muren",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "19066600370",
        "anomalies": null
      },
      {
        "name": "Roy Otterli",
        "positions": [
          {
            "roleCode": "LEDE",
            "roleName": "Styreleder"
          }
        ],
        "personalNumber": "22100250539",
        "anomalies": null
      }
    ],
    [
      {
        "name": "Roy Otterli",
        "positions": [
          {
            "roleCode": "LEDE",
            "roleName": "Styreleder"
          }
        ],
        "personalNumber": "22100250539",
        "anomalies": null
      },
      {
        "name": "Henrik Fallet",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "17056800344",
        "anomalies": null
      }
    ],
    [
      {
        "name": "Ove Os",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "19066600109",
        "anomalies": null
      },
      {
        "name": "Bror Johansen",
        "positions": [
          {
            "roleCode": "DAGL",
            "roleName": "Daglig leder/administrerende direktør"
          },
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "31120000767",
        "anomalies": null
      },
      {
        "name": "Magne Muren",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "19066600370",
        "anomalies": null
      },
      {
        "name": "Stian Kavli",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "20119800324",
        "anomalies": null
      },
      {
        "name": "Roy Otterli",
        "positions": [
          {
            "roleCode": "LEDE",
            "roleName": "Styreleder"
          }
        ],
        "personalNumber": "22100250539",
        "anomalies": null
      },
      {
        "name": "Henrik Fallet",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "17056800344",
        "anomalies": null
      }
    ],
    [
      {
        "name": "Bror Johansen",
        "positions": [
          {
            "roleCode": "DAGL",
            "roleName": "Daglig leder/administrerende direktør"
          },
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "31120000767",
        "anomalies": null
      }
    ]
  ],
  "prokura": []
}

Example: 987569166

Request

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

Response

{
  "companyId": "987569166",
  "changeDate": "2018-10-12",
  "coverage": "None",
  "combinations": [],
  "prokura": []
}

Example: 818711832

Request

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

Response

{
  "companyId": "818711832",
  "changeDate": "2018-10-12",
  "coverage": "Complete",
  "combinations": [
    [
      {
        "name": "Stian Kavli",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "20119800324",
        "anomalies": null
      },
      {
        "name": "Roy Otterli",
        "positions": [
          {
            "roleCode": "LEDE",
            "roleName": "Styreleder"
          }
        ],
        "personalNumber": "22100250539",
        "anomalies": null
      }
    ],
    [
      {
        "name": "Stian Kavli",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "20119800324",
        "anomalies": null
      },
      {
        "name": "Ove Os",
        "positions": [
          {
            "roleCode": "NEST",
            "roleName": "Nestleder"
          }
        ],
        "personalNumber": "19066600109",
        "anomalies": null
      }
    ],
    [
      {
        "name": "Stian Kavli",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "20119800324",
        "anomalies": null
      },
      {
        "name": "Magne Muren",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "19066600370",
        "anomalies": null
      }
    ],
    [
      {
        "name": "Henrik Fallet",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "17056800344",
        "anomalies": null
      },
      {
        "name": "Stian Kavli",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "20119800324",
        "anomalies": null
      }
    ],
    [
      {
        "name": "Ove Os",
        "positions": [
          {
            "roleCode": "NEST",
            "roleName": "Nestleder"
          }
        ],
        "personalNumber": "19066600109",
        "anomalies": null
      },
      {
        "name": "Roy Otterli",
        "positions": [
          {
            "roleCode": "LEDE",
            "roleName": "Styreleder"
          }
        ],
        "personalNumber": "22100250539",
        "anomalies": null
      }
    ],
    [
      {
        "name": "Roy Otterli",
        "positions": [
          {
            "roleCode": "LEDE",
            "roleName": "Styreleder"
          }
        ],
        "personalNumber": "22100250539",
        "anomalies": null
      },
      {
        "name": "Magne Muren",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "19066600370",
        "anomalies": null
      }
    ],
    [
      {
        "name": "Henrik Fallet",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "17056800344",
        "anomalies": null
      },
      {
        "name": "Roy Otterli",
        "positions": [
          {
            "roleCode": "LEDE",
            "roleName": "Styreleder"
          }
        ],
        "personalNumber": "22100250539",
        "anomalies": null
      }
    ],
    [
      {
        "name": "Ove Os",
        "positions": [
          {
            "roleCode": "NEST",
            "roleName": "Nestleder"
          }
        ],
        "personalNumber": "19066600109",
        "anomalies": null
      },
      {
        "name": "Magne Muren",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "19066600370",
        "anomalies": null
      }
    ],
    [
      {
        "name": "Henrik Fallet",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "17056800344",
        "anomalies": null
      },
      {
        "name": "Ove Os",
        "positions": [
          {
            "roleCode": "NEST",
            "roleName": "Nestleder"
          }
        ],
        "personalNumber": "19066600109",
        "anomalies": null
      }
    ],
    [
      {
        "name": "Henrik Fallet",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "17056800344",
        "anomalies": null
      },
      {
        "name": "Magne Muren",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "19066600370",
        "anomalies": null
      }
    ],
    [
      {
        "name": "Henrik Fallet",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "17056800344",
        "anomalies": null
      },
      {
        "name": "Stian Kavli",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "20119800324",
        "anomalies": null
      },
      {
        "name": "Ove Os",
        "positions": [
          {
            "roleCode": "NEST",
            "roleName": "Nestleder"
          }
        ],
        "personalNumber": "19066600109",
        "anomalies": null
      },
      {
        "name": "Roy Otterli",
        "positions": [
          {
            "roleCode": "LEDE",
            "roleName": "Styreleder"
          }
        ],
        "personalNumber": "22100250539",
        "anomalies": null
      },
      {
        "name": "Magne Muren",
        "positions": [
          {
            "roleCode": "MEDL",
            "roleName": "Styremedlem"
          }
        ],
        "personalNumber": "19066600370",
        "anomalies": null
      }
    ],
    [
      {
        "name": "Roy Otterli",
        "positions": [
          {
            "roleCode": "LEDE",
            "roleName": "Styreleder"
          }
        ],
        "personalNumber": "22100250539",
        "anomalies": null
      }
    ]
  ],
  "prokura": [
    [
      {
        "name": "Bror Johansen",
        "positions": [
          {
            "roleCode": "DAGL",
            "roleName": "Daglig leder/administrerende direktør"
          }
        ],
        "personalNumber": "31120000767",
        "anomalies": null
      }
    ]
  ]
}

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