Individual Certifications

Types

The IndividualCertification object

Field	Type	Description
IndividualCertificationId	int	Unique identifier created by NBS. Required for update.
NBSId	int	Unique identifier created by NBS
FirstName	string
LastName	string
CertificationId	int	Maps to the certification object
CertificationName	string
CertificationNumber	string
State	string	State the certification is related to
Country	string	Country the certification is related to
ActivationDate	date
ExpirationDate	date
UpdateDate	date	(read only) Date the individual certification was last updated.
IsMaintained	boolean	(read only) Is the credential marked maintained in NBS.

Endpoints

Get Individual Certification List

Returns latest version of all certifications

Authorization needed

Request

GET https://api.ninthbrain.com/IndividualCertification/GetIndividualCertificationList?updatedSince=2022-03-21&UniqueIdentifier=ABC123&api-version=2.0

Query Parameters

Name	Type	Required	Description
updatedSince	date	optional	If provided only credentials updated the provided date are returned.
NBSId	integer	optional	Used to return credentials for a single employee.
UniqueIdentifier	String	optional	Used to return credentials for a single employee.
EmployeeNumber	String	optional	Used to return credentials for a single employee.

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8

[
	{
		"IndividualCertificationId": 0,
		"NBSId": 0,
		"FirstName": "",
		"LastName": "",
		"CertificationId": 0,
		"CertificationName": "",
		"CertificationNumber": "",
		"State": "",
		"Country": "",
		"ActivationDate": "2021-06-09T00:00:00-04:00",
		"ExpirationDate": "2023-06-20T00:00:00-04:00",
		"UpdateDate": "2021-06-30T15:36:45.257-04:00",		
		"IsMaintained": True
	}
]

Errors

bad_request (HTTP 400)
unauthorized (HTTP 401) - This APIKey is not valid for this service.
not_found (HTTP 404) - Invalid NBSId/UniqueIdentifier/EmployeeNumber provided.

Insert Individual Certification

Request

POST https://api.ninthbrain.com/IndividualCertification/Insert?api-version=2.0

Request Body

HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8

```javascript
{
  "IndividualCertificationId": 0,
  "NBSId": 0,
  "FirstName": "",
  "LastName": "",
  "UniqueIdentifier": "",
  "CertificationId": 0,
  "CertificationName": "",
  "CertificationNumber": "",
  "ActivationDate": "2014-04-14T22:09:50.124896-04:00",
  "ExpirationDate": "2014-04-14T22:09:50.125896-04:00"
}

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8

{
  "IndividualCertificationId": 0,
  "NBSId": 0,
  "FirstName": "",
  "LastName": "",
  "UniqueIdentifier": "",
  "CertificationId": 0,
  "CertificationName": "",
  "CertificationNumber": "",
  "ActivationDate": "2014-04-14T22:09:50.124896-04:00",
  "ExpirationDate": "2014-04-14T22:09:50.125896-04:00",
  "UpdateDate": "2014-04-14T22:09:50.125896-04:00",		
  "IsMaintained": True
}

Errors

unauthorized (HTTP 401) - invalid credentials (bearer token) supplied
not_modified (HTTP 304) - error occurred
bad request (HTTP 400) - unknown error occurred

Update Individual Certification

Request

POST https://api.ninthbrain.com/IndividualCertification/Update?api-version=2.0

Request Body

{
  "IndividualCertificationId": 0,
  "NBSId": 0,
  "FirstName": "",
  "LastName": "",
  "UniqueIdentifier": "",
  "CertificationId": 0,
  "CertificationName": "",
  "CertificationNumber": "",
  "ActivationDate": "2014-04-14T22:09:50.124896-04:00",
  "ExpirationDate": "2014-04-14T22:09:50.125896-04:00"
}

Example response

HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8

{
  "IndividualCertificationId": 0,
  "NBSId": 0,
  "FirstName": "",
  "LastName": "",
  "UniqueIdentifier": "",
  "CertificationId": 0,
  "CertificationName": "",
  "CertificationNumber": "",
  "ActivationDate": "2014-04-14T22:09:50.124896-04:00",
  "ExpirationDate": "2014-04-14T22:09:50.125896-04:00",
  "UpdateDate": "2014-04-14T22:09:50.125896-04:00",		
  "IsMaintained": True
}

Errors

unauthorized (HTTP 401) - invalid credentials (bearer token) supplied
not_modified (HTTP 304) - error occurred
bad request (HTTP 400) - unknown error occurred