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/v1/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.

{
    "status": "success",
    "person_found": true,
    "is_certificate_valid": false,
    "certificate_issued_at": null,
    "certificate_expires_at": null
}

Unsuccessful response sample:

{
    "status": "failure",
    "message": "Wrong API Key"
}