Cerrtify
Person Data

Search by name/address (parsed JSON)

As `/search/name-address`, but parsed into JSON. Always synchronous. > **Production uses your own SPAR agreement.** Upload the certificate and > Skatteverket's customer numbers in the Cerrtify dashboard; until then > production returns `403 spar_not_configured`. Sandbox uses the > platform's test certificate against Skatteverket's SPAR test > environment; you need none of your own.

POST
/service/persondata/search/name-address.json

Authorization

ApiKeyAuth
X-API-Key<token>

API key in the form cert_<prefix>_<secret>.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

At least one field must be set; empty fields are omitted from the SPAR query. SPAR's own limits apply and are checked before the call (400 invalid_request): names take letters, digits, spaces and * - ' (fornamn max 80, mellanEfternamn max 60 characters); utdelningsadress also / . , : (max 100); postort letters, digits, spaces, * and - (max 27); postnr five digits.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/service/persondata/search/name-address.json" \  -H "Content-Type: application/json" \  -d '{}'
{  "Posts": [    {      "PersonId": {        "IdNummer": "string",        "Typ": "PERSONNUMMER"      },      "Sekretessmarkering": "JA",      "SekretessSattAvSPAR": "string",      "SekretessDatum": "2019-08-24",      "SkyddadFolkbokforing": "JA",      "SkyddadFolkbokforingDatum": "2019-08-24",      "SenasteAndringSPAR": "2019-08-24",      "Namn": [        {          "DatumFrom": "2019-08-24",          "DatumTill": "2019-08-24",          "Aviseringsnamn": "string",          "Fornamn": "string",          "Tilltalsnamn": "string",          "Mellannamn": "string",          "Efternamn": "string"        }      ],      "Persondetaljer": [        {          "DatumFrom": "2019-08-24",          "DatumTill": "2019-08-24",          "Sekretessmarkering": "JA",          "SkyddadFolkbokforing": "JA",          "AvregistreringsorsakKod": "string",          "Avregistreringsdatum": "string",          "Avlidendatum": "string",          "AntraffadDodDatum": "string",          "Fodelsedatum": "2019-08-24",          "FodelselanKod": "string",          "Fodelseforsamling": "string",          "Kon": "MAN",          "SvenskMedborgare": "JA",          "Hanvisning": [            {              "IdNummer": "string",              "Typ": "Till"            }          ],          "SnIdentitetsniva": "string",          "SnIdentitetsnivaDatum": "string",          "SnStatus": "string",          "SnTilldelningsdatum": "string",          "SnPreliminartVilandeforklaringsdatum": "string",          "SnFornyelsedatum": "string",          "SnVilandeorsak": "string",          "SnVilandeforklaringsdatum": "string",          "SnAvlidendatum": "string"        }      ],      "Utvandrad": {        "Aterinlasningsdatum": "2019-08-24",        "Forlangningsdatum": "2019-08-24"      },      "Folkbokforing": [        {          "DatumFrom": "2019-08-24",          "DatumTill": "2019-08-24",          "FolkbokfordLanKod": "string",          "FolkbokfordKommunKod": "string",          "Hemvist": "string",          "Folkbokforingsdatum": "2019-08-24",          "DistriktKod": "string"        }      ],      "Folkbokforingsadress": [        {          "SvenskAdress": {            "DatumFrom": "2019-08-24",            "DatumTill": "2019-08-24",            "CareOf": "string",            "Utdelningsadress1": "string",            "Utdelningsadress2": "string",            "PostNr": "string",            "Postort": "string"          }        }      ],      "SarskildPostadress": [        {          "SvenskAdress": {            "DatumFrom": "2019-08-24",            "DatumTill": "2019-08-24",            "CareOf": "string",            "Utdelningsadress1": "string",            "Utdelningsadress2": "string",            "PostNr": "string",            "Postort": "string"          },          "InternationellAdress": {            "DatumFrom": "2019-08-24",            "DatumTill": "2019-08-24",            "Utdelningsadress1": "string",            "Utdelningsadress2": "string",            "Utdelningsadress3": "string",            "Land": "string"          }        }      ],      "Utlandsadress": [        {          "InternationellAdress": {            "DatumFrom": "2019-08-24",            "DatumTill": "2019-08-24",            "Utdelningsadress1": "string",            "Utdelningsadress2": "string",            "Utdelningsadress3": "string",            "Land": "string"          }        }      ],      "Kontaktadress": [        {          "SvenskAdress": {            "DatumFrom": "2019-08-24",            "DatumTill": "2019-08-24",            "CareOf": "string",            "Utdelningsadress1": "string",            "Utdelningsadress2": "string",            "PostNr": "string",            "Postort": "string"          },          "InternationellAdress": {            "DatumFrom": "2019-08-24",            "DatumTill": "2019-08-24",            "Utdelningsadress1": "string",            "Utdelningsadress2": "string",            "Utdelningsadress3": "string",            "Land": "string"          }        }      ],      "Relation": [        {          "DatumFrom": "2019-08-24",          "DatumTill": "2019-08-24",          "Relationstyp": "VÅRDNADSHAVARE",          "IdNummer": "string",          "Fornamn": "string",          "Mellannamn": "string",          "Efternamn": "string",          "Fodelsetid": "2019-08-24",          "AvregistreringsorsakKod": "string",          "Avregistreringsdatum": "string",          "Avlidendatum": "string"        }      ],      "Fastighet": [        {          "Taxeringsenhetsnummer": "string",          "LanKod": "string",          "KommunKod": "string",          "FastighetKod": "string",          "Taxeringsar": "string",          "Taxeringsvarde": "string",          "FastighetDel": [            {              "Taxeringsidentitet": "string",              "FastighetBeteckning": "string",              "AndelstalTaljare": "string",              "AndelstalNamnare": "string"            }          ]        }      ],      "SummeradInkomst": "string",      "InkomstAr": "string"    }  ],  "Undantag": {    "Kod": "string",    "Beskrivning": "string"  },  "OverstigerMaxAntalSvarsposter": {    "AntalPoster": 0,    "MaxAntalSvarsposter": 0  },  "UUID": "string"}
{  "error": "string",  "detail": "string"}
{  "error": "string",  "detail": "string"}
{  "error": "insufficient_credits",  "message": "Organisationen har slut på krediter. Fyll på för att fortsätta."}
{  "error": "string",  "detail": "string"}
{  "error": "string",  "detail": "string"}
{  "error": "upstream_unavailable",  "service": "bankid",  "message": "There is currently a problem with BankID. Please try again shortly."}
{  "error": "string",  "detail": "string"}

Search by name/address (raw SPAR XML) POST

Searches SPAR by any combination of name and address fields. Returns raw SPAR SOAP XML. > **Production uses your own SPAR agreement.** Upload the certificate and > Skatteverket's customer numbers in the Cerrtify dashboard; until then > production returns `403 spar_not_configured`. Sandbox uses the > platform's test certificate against Skatteverket's SPAR test > environment; you need none of your own.

Start a BankID authentication order POST

Starts a BankID authentication order and returns an `orderRef` plus autostart/QR tokens. After this call, either: - poll `GET /service/bankid/qr-code?orderRef=...` to render the rotating QR, and - poll `POST /service/bankid/collect` with the `orderRef` until the order completes. `userVisibleData` is plain text — the server base64-encodes it before forwarding to BankID.