Skip to content

Lookup address


Target audience: Developers

Release version: 3.9.1

Lookup address


This endpoint returns the address information connected to a ssn, taking leverage of the national registry. Please contact support if you have any questions about this.


Environment URI


Identity Scope
No /external/account/r


Name Required Type Description
social_security_number Required String The social security number to look up.
Size range: 10..12
Allowed values: "dddddd-dddd or "dddddddddd""

Curl Example

curl --request GET \
  --url \
  --header 'accept: application/json' \
  --header 'authorization: Bearer <token>'


Example response

HTTP 200
    "item": {
        "first_name": "Anders",
        "last_name": "Andersson",
        "street": "Anders gata",
        "street_number": "12",
        "staircase": "A",
        "floor": "3",
        "apartment": "APT",
        "apartment_number": "13",
        "zip_code": "83242",
        "city": "Stockholm",
        "drop_box": null


Example error response

HTTP 400 Bad Request
    "code": "invalid_parameter",
    "message": "expecting something like 620817-9256 or 196208179256"

HTTP 400 Bad Request

Name Type Description
invalid_parameter Object One or more of the parameters was not recognized

HTTP 403 Forbidden

Name Type Description
forbidden Object Customer lookup service is not registered on your account.

HTTP 404 Not Found

Name Type Description
not_found Object The social_security_number could not be found

HTTP 500 Internal Server Error

Name Type Description
internal_server_error Object Something unexpected happened server side