Roaring logo
Log in

Population Register

Information about persons registered in Sweden

Population Register

[se]
Requires addon

Documentation

Retrieve and Monitor Identity Data with Population Register API. The Population Register API provides verified identity and residency information, helping businesses strengthen due diligence, meet AML/KYC requirements, and prevent fraud. It enables secure, compliant decision-making by ensuring access to up-to-date personal data. With this API, you can:

  • Retrieve address information, names, relationships, and historical data from social security numbers
  • Create frictionless B2C onboarding and checkout flows
  • Verify individual identities for risk assessments
  • Monitor changes over time to keep your customer data accurate

Use case:

A financial institution onboarding a new private (B2C) customer uses the Population Register API to instantly verify the customer's identity and address, ensuring fast, secure registration while meeting compliance requirements.

This information can be monitored as webhooks

This information can easily be monitored and pushed as event notification as webhooks.

  • Setup the webhooks here
  • Read our webhooks guide here
  • Any questions, please contact our Customer Support, you find the chat icon in the lower right corner.

Apply for production data

In order to access population registry data through Roaring you need to apply for access via the admin pages of app.roaring.io.

This API requires permission. In order for you to get started you need to apply for this through your account. Access ADMIN, Account information, Permissions. In the message you send to request access please include information on which redirection mode you want to use for your access.

This api has different kinds of access options available. Information can either be fetched directly from the population registry or via cached data from one of our data partners. The reason for having multiple ways of fetching population registry data is the unstable nature of the government managed API’s.

In order to get access to the government managed API’s for population registry information you need a permission from the tax authority (Skatteverket). Roaring will help you with the application process towards Skatteverket this usually takes 2-3 weeks from start to finish.

The cached version of the population registry is updated from the population registry on a daily basis at our data partner and does not need an access application to any third party. The caveat with the cached version of the population registry is that it doesn’t include people with coordination number (samordningsnummer) and people under the age of 16.

NOTE: Important to notice is that the cached version of the population registry does not include people with coordination number (samordningsnummer) and people under the age of 16.

Having access to a cached source for the population registry gives us the flexibility of some different setup options for usage and gives you the option of choosing how you want the API to handle your request. There are (at the moment) three different redirect modes to the API:

  • NEVER The API directly call the government population registry API for every request.

  • FALLBACK The API directly calls the government population registry API for every request. But if there is an error returned or if the call takes more than one second, the call is redirected to our data partner´s API to retrieve a response from the cached population registry record.

  • ALWAYS The API always redirect the calls to our data partners API to retrieve a response from the cached population registry. This option does not need you to apply for population registry access but can be added to your account directly

Data limitations between the the government managed API’s and our Fallback data partners API

Important note: There is some data difference between the government managed API’s and our Fallback data partners API. Below is the limitations of the Fallback (cached copy)

General:

  • Only individuals 16 years and older are included
  • Only personal numbers, not coordination or immunity numbers are included

Data details which are not available in the fallback/cached copy

  • Reference to old personal or coordination number
  • Residence status code
  • “Protected in the National register” (Skyddad folkbokföring) and “Secrecy set by Spar” (“Secrecy” flag is available)
  • Contact address
  • Deregistration date and death date
  • Persons deregistered with deregistration codes: AS, FI, OB and TA are not available (no record found)
  • District code
  • Name history, and start date of current name
  • Population registration date history
  • Shortened name
  • Start date of address missing if there is no address history for the person
  • Swedish citizen flag (only relevant for authorities like the Police and Customs etc, others don´t ever get access to this)
  • Income/Taxation/Real estate information (only relevant for authorities like the Police and Customs etc, others don´t ever get access to this)

Schema version

The population register API is built against SPAR schemaversion "2021.1" while the population register webhook is built against schemaversion "2019.1.".

Note that small discrepancies can occur between these two versions.

Deregistration reason codes

Below is a list of available deregistration codes for a person.

Code
Explanation (Svenska)
Explanation (English)
Notes
ASAnnullerat samordningsnummerAnnulled Coordination Number
AVAvlidenDeceased
FIFalsk identitetFalse identity
GNBytt personnummerChanged social security numberReference is made to the new number
GSBytt samordningsnummerChanged coordination numberReference is made to the new number
OBFörsvunnenDisappeared
TATeknisk avregistreringTechnical deregistration
UVUtvandradEmigrated
AAvlidenDeceasedOld code, corresponds to the new code AV
GBytt personnummerChanged social security numberOld code, corresponds to the new codes GN/GS. Reference is made to the new number

Rows per page

Page 1 of 2

Country names

Countries are written as a string, based on the code table in the pdf document "Landskoder i folkbokföringen", published here: Skatteverket

Swedish counties and municipalities

Below is a list of counties and municipalities. The first two digits = county. The last two digits = municipality(commune)

Code
Name
01Stockholms län
0114Upplands Väsby
0115Vallentuna
0117Österåker
0120Värmdö
0123Järfälla
0125Ekerö
0126Huddinge
0127Botkyrka
0128Salem

Rows per page

Page 1 of 32

Source: Statistiska centralbyrån

Person Id Types

Code
Explanation (Svenska)
Explanation (English)
PERSONNUMMERPersonnummerSwedish national social security number
SAMORDNINGSNUMMERSamordningsnummerCoordination number
IMMUNITETSNUMMERImmunitetsnummerImmunity number

Residence status code

Code
Explanation (Svenska)
Explanation (English)
MUNICIPALPersonen saknar bostad, men nås via adressenThe person does not have a residence, but can be reached via the address
RESIDENTIALFolkbokföringsadressen är där personen är folkbokördThe residential address is where the person lives
UNKNOWNEj känt var personen borThe person does not have a known residence

Endpoints

Find person by personId

gethttps://api.roaring.io/person/2.0/current/{personId}

Parameters path

personId

required

string
person id

Response schema: application/json

Find person by personId

gethttps://api.roaring.io/person/2.0/full/{personId}

Parameters path

personId

required

string
person id