Check certificate status for person, using NIN

Check if person, using National identification number, have a valid certificate using GET.

Request

For every API request you make, you'll need to present the API access key in the HTTP Header as X-API-Key to be authenticated.

Parameters

Name	Required	Value	Description
nin	required	string	National identification number

Example code in PHP

$request_url = 'https://www.kursguiden.no/api/v2/certificate/check/01017077665';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $request_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); 

curl_setopt($ch, CURLOPT_HTTPHEADER, array(
  'X-API-Key: {your-api-key}',
  'Accept: application/json',
));
$result = curl_exec($ch);
curl_close($ch);
               

Response

If the method is successful it responds with an JSON structure, as it is shown below.

{
    "person_found": true,
    "is_certificate_valid": false,
    "certificate_issued_at": null,
    "certificate_expires_at": null,
    "user": {
        "id": 154420,
        "nin": "01017077665",
        "firstname": "Lars",
        "lastname": "Larsen",
        "email": "lars@eksemel.ek",
        "phone": "21212121"
    }
}

Unsuccessful response sample:

{
    "error": "Wrong API Key"
}