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 Date the individual certification was last updated.

Endpoints

Get Individual Certification List

Returns latest version of maintained 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
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1342521939
[
	{
		"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"
	}
]
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
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1342521939
{
  "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"
}
Example response
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1342521939
{
  "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"
}
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",
  "UpdateDate": "2014-04-14T22:09:50.125896-04:00"
}
Example response
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1342521939
{
  "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"
}
Errors
  • unauthorized (HTTP 401) - invalid credentials (bearer token) supplied
  • not_modified (HTTP 304) - error occurred
  • bad request (HTTP 400) - unknown error occurred