DBR CPR API (2.0)

Download OpenAPI specification:Download

Jack Lilleskov: LilleskovJ@dnb.com URL: https://www.registret.dk License: Proprietary Terms of Service

REST API

CPR API allows for querying for persons in CPR (Civil Registration Register)

CPR API v1

Query for persons in CPR using a person's PNR or name, address, and/or birthdate. This CPR Version is deprecated use V2 instead.

PNR query Deprecated

Query for person in CPR by Personal Identification Number (PNR).

This endpoint is deprecated use CPR API V2 instead.

Authorizations:

oauth2

Request Body schema: application/json

pnr

required

string

Personal identification number

Responses

Request samples

Payload

Content type

application/json

{"pnr": "0707614293"
}

Response samples

200
400
404
502

Content type

application/json

{"person": {"pnr": "0107614293",
"status": {"statusCode": "string",
"statusChange": "2015-08-01",
"description": "string",
"active": true
},
"name": {"firstAndMiddleName": "Vinnie Peters",
"lastName": "Madsen",
"formattedName": "Madsen, Vinnie Peters"
},
"birthdate": "1961-07-01",
"gender": "Male",
"occupation": "Doktor",
"address": {"careOf": "c/o Jens Hansen",
"standardAddress": "Svinget 50A, 3. tv",
"streetName": "Svinget",
"houseNumber": "50",
"houseLetter": "A",
"floor": "3, st, kl",
"door": "tv",
"building": "10",
"locality": "Hedehuset",
"town": "Lindholm",
"postalCode": "9000",
"postalDistrict": "Aalborg C",
"streetCode": "1301",
"municipalityCode": "0240",
"municipalityName": "Egedal",
"addressId": "0a3f507a-93e7-32b8-e044-0003ba298018",
"validFrom": "2018-04-18",
"kvhx": "04615319__93__1____"
},
"nameAndAddressProtected": {"state": true,
"date": "2018-04-18"
},
"marketingProtected": {"state": true,
"date": "2018-04-18"
},
"identityStop": {"code": "5",
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z"
},
"foreignAddress": {"addressLine1": "string",
"addressLine2": "string",
"addressLine3": "string",
"addressLine4": "string",
"addressLine5": "string",
"countryCode": "US",
"validFrom": "2016-08-20"
},
"contactAddress": {"addressLine1": "string",
"addressLine2": "string",
"addressLine3": "string",
"addressLine4": "string",
"addressLine5": "string",
"validFrom": "2016-08-20"
},
"guardian": {"guardianName": "string",
"type": "Full",
"addressLine1": "string",
"addressLine2": "string",
"addressLine3": "string",
"addressLine4": "string",
"addressLine5": "string",
"validFrom": "2016-08-20"
}
},
"dbrId": "string",
"requested": "2018-04-16T09:32:37Z"
}

Match query Deprecated

Query for person in CPR by name, address and/or birthdate.

This endpoint is deprecated use CPR API V2 instead.

Authorizations:

oauth2

Request Body schema: application/json

name	string Name of person. Must consist of minimum two and maximum 4 name parts. Max. length 66 characters
	object (QueryAddress) Address for person query. Name and either postalDistrict or municipality are required
birthdate	string Birthdate of person

Responses

Request samples

Payload

Content type

application/json

{"name": "Lars Henriksen",
"address": {"street": "Svinget",
"houseNo": "50A",
"door": "tv",
"floor": "1",
"postalDistrict": "9000 or Aalborg",
"municipality": "851 or Aalborg"
},
"birthdate": "1961-12-31"
}

Response samples

200
400
404
502

Content type

application/json

{"person": {"pnr": "0107614293",
"status": {"statusCode": "string",
"statusChange": "2015-08-01",
"description": "string",
"active": true
},
"name": {"firstAndMiddleName": "Vinnie Peters",
"lastName": "Madsen",
"formattedName": "Madsen, Vinnie Peters"
},
"birthdate": "1961-07-01",
"gender": "Male",
"occupation": "Doktor",
"address": {"careOf": "c/o Jens Hansen",
"standardAddress": "Svinget 50A, 3. tv",
"streetName": "Svinget",
"houseNumber": "50",
"houseLetter": "A",
"floor": "3, st, kl",
"door": "tv",
"building": "10",
"locality": "Hedehuset",
"town": "Lindholm",
"postalCode": "9000",
"postalDistrict": "Aalborg C",
"streetCode": "1301",
"municipalityCode": "0240",
"municipalityName": "Egedal",
"addressId": "0a3f507a-93e7-32b8-e044-0003ba298018",
"validFrom": "2018-04-18",
"kvhx": "04615319__93__1____"
},
"nameAndAddressProtected": {"state": true,
"date": "2018-04-18"
},
"marketingProtected": {"state": true,
"date": "2018-04-18"
},
"identityStop": {"code": "5",
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z"
},
"foreignAddress": {"addressLine1": "string",
"addressLine2": "string",
"addressLine3": "string",
"addressLine4": "string",
"addressLine5": "string",
"countryCode": "US",
"validFrom": "2016-08-20"
},
"contactAddress": {"addressLine1": "string",
"addressLine2": "string",
"addressLine3": "string",
"addressLine4": "string",
"addressLine5": "string",
"validFrom": "2016-08-20"
},
"guardian": {"guardianName": "string",
"type": "Full",
"addressLine1": "string",
"addressLine2": "string",
"addressLine3": "string",
"addressLine4": "string",
"addressLine5": "string",
"validFrom": "2016-08-20"
}
},
"dbrId": "string",
"requested": "2018-04-16T09:32:37Z"
}

CPR API v2

Query for persons in CPR using a person's PNR or name, address, and/or birthdate.

PNR query

Query for person in CPR by Personal Identification Number (PNR)

Authorizations:

oauth2

header Parameters

X-LOG-TOKEN

any

Custom correlation token to track request. Will be return in the response

Request Body schema: application/json

pnr

required

string

Personal identification number

Responses

Request samples

Payload

Content type

application/json

{"pnr": "0707614293"
}

Response samples

200
400
404
502

Content type

application/json

{"person": {"pnr": "0107614293",
"status": {"statusCode": "string",
"statusChange": "2015-08-01",
"description": "string",
"active": true
},
"name": {"firstAndMiddleName": "Vinnie Peters",
"lastName": "Madsen",
"formattedName": "Madsen, Vinnie Peters"
},
"birthdate": "1961-07-01",
"gender": "Male",
"occupation": "Doktor",
"address": {"careOf": "c/o Jens Hansen",
"standardAddress": "Svinget 50A, 3. tv",
"streetName": "Svinget",
"houseNumber": "50",
"houseLetter": "A",
"floor": "3, st, kl",
"door": "tv",
"building": "10",
"locality": "Hedehuset",
"town": "Lindholm",
"postalCode": "9000",
"postalDistrict": "Aalborg C",
"streetCode": "1301",
"municipalityCode": "0240",
"municipalityName": "Egedal",
"addressId": "0a3f507a-93e7-32b8-e044-0003ba298018",
"validFrom": "2018-04-18",
"kvhx": "04615319__93__1____"
},
"nameAndAddressProtected": {"state": true,
"date": "2018-04-18"
},
"marketingProtected": {"state": true,
"date": "2018-04-18"
},
"identityStop": {"code": "5",
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z"
},
"foreignAddress": {"addressLine1": "string",
"addressLine2": "string",
"addressLine3": "string",
"addressLine4": "string",
"addressLine5": "string",
"countryCode": "US",
"validFrom": "2016-08-20"
},
"contactAddress": {"addressLine1": "string",
"addressLine2": "string",
"addressLine3": "string",
"addressLine4": "string",
"addressLine5": "string",
"validFrom": "2016-08-20"
},
"guardian": {"guardianName": "string",
"type": "Full",
"addressLine1": "string",
"addressLine2": "string",
"addressLine3": "string",
"addressLine4": "string",
"addressLine5": "string",
"validFrom": "2016-08-20"
}
},
"dbrId": "string",
"requested": "2018-04-16T09:32:37Z"
}

Match query

Query for person in CPR by name, address, and birthdate

Authorizations:

oauth2

header Parameters

X-LOG-TOKEN	any Custom correlation token to track request. Will be return in the response
Authorization	string

Request Body schema: application/json

name	string Name of person. Must consist of minimum two and maximum 4 name parts. Max. length 66 characters
	object (QueryAddress) Address for person query. Name and either postalDistrict or municipality are required
birthdate	string Birthdate of person

Responses

Request samples

Payload

Content type

application/json

{"name": "Lars Henriksen",
"address": {"street": "Svinget",
"houseNo": "50A",
"door": "tv",
"floor": "1",
"postalDistrict": "9000 or Aalborg",
"municipality": "851 or Aalborg"
},
"birthdate": "1961-12-31"
}

Response samples

200
400
404
409
502

Content type

application/json

{"person": {"pnr": "0107614293",
"status": {"statusCode": "string",
"statusChange": "2015-08-01",
"description": "string",
"active": true
},
"name": {"firstAndMiddleName": "Vinnie Peters",
"lastName": "Madsen",
"formattedName": "Madsen, Vinnie Peters"
},
"birthdate": "1961-07-01",
"gender": "Male",
"occupation": "Doktor",
"address": {"careOf": "c/o Jens Hansen",
"standardAddress": "Svinget 50A, 3. tv",
"streetName": "Svinget",
"houseNumber": "50",
"houseLetter": "A",
"floor": "3, st, kl",
"door": "tv",
"building": "10",
"locality": "Hedehuset",
"town": "Lindholm",
"postalCode": "9000",
"postalDistrict": "Aalborg C",
"streetCode": "1301",
"municipalityCode": "0240",
"municipalityName": "Egedal",
"addressId": "0a3f507a-93e7-32b8-e044-0003ba298018",
"validFrom": "2018-04-18",
"kvhx": "04615319__93__1____"
},
"nameAndAddressProtected": {"state": true,
"date": "2018-04-18"
},
"marketingProtected": {"state": true,
"date": "2018-04-18"
},
"identityStop": {"code": "5",
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z"
},
"foreignAddress": {"addressLine1": "string",
"addressLine2": "string",
"addressLine3": "string",
"addressLine4": "string",
"addressLine5": "string",
"countryCode": "US",
"validFrom": "2016-08-20"
},
"contactAddress": {"addressLine1": "string",
"addressLine2": "string",
"addressLine3": "string",
"addressLine4": "string",
"addressLine5": "string",
"validFrom": "2016-08-20"
},
"guardian": {"guardianName": "string",
"type": "Full",
"addressLine1": "string",
"addressLine2": "string",
"addressLine3": "string",
"addressLine4": "string",
"addressLine5": "string",
"validFrom": "2016-08-20"
}
},
"dbrId": "string",
"requested": "2018-04-16T09:32:37Z"
}