View customer's enrollment sending, certificates, and notifications

As a Reseller you can view a customer's training enrollment sending report (emails sent, delivery status), certificates, reminder mails, and notification activity logs for a specific enrollment. Get the customer's Company ID and the enrollment ID from the enrollment list, then call the training-report and enrollment endpoints with X-KEEPNET-Company-Id so results are scoped to that customer. Use a credential with Client Role = Reseller.

---

POST /api/companies/search

Get the customer's Company ID. Use the resourceId of the desired company in the next steps.

Retrieves a paginated list of all companies you manage with license details. Each item includes resourceId — use it as the Company ID for scoped requests. Test it: Authorize with Client ID/Secret, then Send — request body is pre-filled.

Retrieves a list of all companies

post

Required scopes

This endpoint requires the following scopes:

• : API

Authorizations

oauth2bearerAuth

OAuth2clientCredentialsRequired

Client ID and Client Secret from Company → Company Settings → REST API. Enter credentials to auto-fetch token.

Token URL:

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

pageNumberintegerRequiredExample: 1

pageSizeintegerRequiredExample: 10

orderBystringRequiredExample: CreateTime

ascendingbooleanRequiredExample: false

isTargetUserCountExceededLimitbooleanOptional

If true, only companies exceeding license limit are returned

Example: false

Responses

200

OK

application/json

statusstringOptional

messagestring · nullableOptional

validationMessagesstring[] · nullableOptional

post

/api/companies/search

HTTPcURLJavaScriptPython

POST /api/companies/search HTTP/1.1
Host: api.keepnetlabs.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 126

{
  "pageNumber": 1,
  "pageSize": 10,
  "orderBy": "CreateTime",
  "ascending": false,
  "filter": {
    "Condition": "AND",
    "SearchInputTextValue": ""
  }
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

200

OK

{
  "data": {
    "limitExceededCompanyCount": 1,
    "pageNumber": 1,
    "pageSize": 1,
    "totalNumberOfPages": 1,
    "totalNumberOfRecords": 1,
    "results": [
      {
        "companyName": "text",
        "companyResourceId": "text",
        "resellerName": "text",
        "industryName": "text",
        "industryResourceId": "text",
        "licenseTypeName": "text",
        "licenseTypeResourceId": "text",
        "isNumberOfUsersLimited": true,
        "numberOfUsers": "text",
        "privacyDurationId": 1,
        "licenceExpired": true,
        "licenseEndDate": "2026-03-09T13:38:37.349Z",
        "createTime": "2026-03-09T13:38:37.349Z",
        "targetUserCount": 1,
        "children": [
          {
            "companyName": "text",
            "companyResourceId": "text",
            "resellerName": "text",
            "industryName": "text",
            "industryResourceId": "text",
            "licenseTypeName": "text",
            "licenseTypeResourceId": "text",
            "isNumberOfUsersLimited": true,
            "numberOfUsers": "text",
            "privacyDurationId": 1,
            "licenceExpired": true,
            "licenseEndDate": "2026-03-09T13:38:37.349Z",
            "createTime": "2026-03-09T13:38:37.349Z",
            "targetUserCount": 1,
            "children": "[Circular Reference]",
            "tags": [
              "text"
            ],
            "deletedTargetUserCount": 1,
            "inactiveTargetUserCount": 1,
            "monthlyActiveUserCount": 1
          }
        ],
        "tags": [
          "text"
        ],
        "deletedTargetUserCount": 1,
        "inactiveTargetUserCount": 1,
        "monthlyActiveUserCount": 1
      }
    ]
  },
  "status": "text",
  "message": "text",
  "validationMessages": [
    "text"
  ]
}

From the response, pick the company and note its resourceId. Example: "resourceId": "xC5kfGz7w2Nz" → use as X-KEEPNET-Company-Id in all following requests.

---

POST /api/enrollments/search

Get the customer's enrollment list so you can choose an enrollment to inspect. Send X-KEEPNET-Company-Id. From the response, take the resourceId of the enrollment you want (e.g. "resourceId": "eNrl9Ab3k2Qp") — that is the enrollmentId for the sending, certificates, reminder, and notification endpoints below.

Returns a list of enrollments. As a Reseller, send X-KEEPNET-Company-Id: <companyResourceId>. Request body: filter (required — use the structure with Condition, SearchInputTextValue, FilterGroups; see View customer's enrollment list and report for a full example), optional pageNumber, pageSize, orderBy, ascending, enrollmentType.

Returns a list of enrollments

post

Required scopes

This endpoint requires the following scopes:

• : API

Authorizations

oauth2bearerAuth

OAuth2clientCredentialsRequired

Client ID and Client Secret from Company → Company Settings → REST API. Enter credentials to auto-fetch token.

Token URL:

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

pageNumberintegerRequiredExample: 1

pageSizeintegerRequiredExample: 20

orderBystringRequiredExample: CreateTime

ascendingbooleanRequiredExample: false

enrollmentTypestringOptional

Optional: use "Survey" to list only survey enrollments

Example: Survey

Responses

200

OK

application/json

statusstring · nullableOptional

messagestring · nullableOptional

validationMessagesstring[] · nullableOptional

post

/api/enrollments/search

HTTPcURLJavaScriptPython

POST /api/enrollments/search HTTP/1.1
Host: api.keepnetlabs.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 252

{
  "pageNumber": 1,
  "pageSize": 20,
  "orderBy": "CreateTime",
  "ascending": false,
  "filter": {
    "Condition": "AND",
    "SearchInputTextValue": "",
    "FilterGroups": [
      {
        "Condition": "AND",
        "FilterItems": [],
        "FilterGroups": []
      },
      {
        "Condition": "OR",
        "FilterItems": [],
        "FilterGroups": []
      }
    ]
  }
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

200

OK

{
  "data": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalNumberOfPages": 1,
    "totalNumberOfRecords": 1,
    "results": [
      {
        "tags": [
          "text"
        ],
        "languages": [
          "text"
        ],
        "enrollmentId": "text",
        "name": "text",
        "enrolledBy": "text",
        "startDate": "2026-03-09T13:38:37.349Z",
        "trainingName": "text",
        "delivery": "text",
        "deliveryType": "text",
        "createTime": "2026-03-09T13:38:37.349Z",
        "isReminderActive": true,
        "isAutoEnrollmentActive": true,
        "status": "text",
        "recipientType": "text",
        "category": "text",
        "type": "text",
        "hasQuiz": true,
        "sendTemplatesInPreferredLanguage": true,
        "trainingRoles": [
          {
            "roleId": 1,
            "code": "text",
            "roleName": "text"
          }
        ],
        "duration": "text",
        "level": "text"
      }
    ]
  },
  "status": "text",
  "message": "text",
  "validationMessages": [
    "text"
  ]
}

---

POST /api/training-reports/{enrollmentId}/sending-report/search

Returns the sending report for that enrollment: emails sent, delivery status, and related data. Send X-KEEPNET-Company-Id. Replace {enrollmentId} with the enrollment resourceId from the enrollment list.

Returns sending report training report for an enrollment. As a Reseller, send X-KEEPNET-Company-Id: <companyResourceId>.

Returns sending report training report for an enrollment

post

Required scopes

This endpoint requires the following scopes:

• : API

Authorizations

oauth2bearerAuth

OAuth2clientCredentialsRequired

Client ID and Client Secret from Company → Company Settings → REST API. Enter credentials to auto-fetch token.

Token URL:

Path parameters

enrollmentIdstringRequired

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

pageNumberinteger · int32Optional

pageSizeinteger · int32Optional

orderBystring · nullableOptional

ascendingbooleanOptional

Responses

200

OK

application/json

statusstring · nullableOptional

messagestring · nullableOptional

validationMessagesstring[] · nullableOptional

post

/api/training-reports/{enrollmentId}/sending-report/search

HTTPcURLJavaScriptPython

POST /api/training-reports/{enrollmentId}/sending-report/search HTTP/1.1
Host: api.keepnetlabs.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 377

{
  "filter": {
    "searchInputTextValue": "text",
    "condition": "text",
    "filterGroups": [
      {
        "condition": "text",
        "filterItems": [
          {
            "fieldName": "text",
            "operator": "text",
            "value": "text"
          }
        ],
        "filterGroups": [
          {
            "condition": "text",
            "filterItems": [
              {
                "fieldName": "text",
                "operator": "text",
                "value": "text"
              }
            ],
            "filterGroups": "[Circular Reference]"
          }
        ]
      }
    ]
  },
  "pageNumber": 1,
  "pageSize": 1,
  "orderBy": "text",
  "ascending": true
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

200

OK

{
  "data": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalNumberOfPages": 1,
    "totalNumberOfRecords": 1,
    "results": [
      {
        "emailDelivery": "text",
        "firstSendDate": "2026-03-09T13:38:37.349Z",
        "lastSendDate": "2026-03-09T13:38:37.349Z",
        "lastSendingStatus": "text",
        "errorMessage": "text",
        "targetUserStatus": "text",
        "targetUserIsDeleted": true,
        "enrollmentId": "text",
        "targetUserResourceId": "text",
        "userId": 1,
        "resourceId": "text",
        "firstName": "text",
        "lastName": "text",
        "email": "text",
        "department": "text",
        "isMainScore": true,
        "customFieldValues": [
          {
            "resourceId": "text",
            "name": "text",
            "dataType": "text",
            "value": "text",
            "timestampValue": "2026-03-09T13:38:37.349Z"
          }
        ]
      }
    ]
  },
  "status": "text",
  "message": "text",
  "validationMessages": [
    "text"
  ]
}

To export: POST /api/training-reports/{enrollmentId}/sending-report/search/export — same header and body shape; see Endpoints → TrainingReport.

---

POST /api/enrollments/{enrollmentId}/certificates/search

Search certificates issued for that enrollment. Send X-KEEPNET-Company-Id. Replace {enrollmentId} with the enrollment resourceId.

Search enrollment certificates. As a Reseller, send X-KEEPNET-Company-Id: <companyResourceId>.

Search enrollment certificates

post

Required scopes

This endpoint requires the following scopes:

• : API

Authorizations

oauth2bearerAuth

OAuth2clientCredentialsRequired

Client ID and Client Secret from Company → Company Settings → REST API. Enter credentials to auto-fetch token.

Token URL:

Path parameters

enrollmentIdstringRequired

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

pageNumberinteger · int32Optional

pageSizeinteger · int32Optional

orderBystring · nullableOptional

ascendingbooleanOptional

Responses

200

OK

application/json

statusstring · nullableOptional

messagestring · nullableOptional

validationMessagesstring[] · nullableOptional

post

/api/enrollments/{enrollmentId}/certificates/search

HTTPcURLJavaScriptPython

POST /api/enrollments/{enrollmentId}/certificates/search HTTP/1.1
Host: api.keepnetlabs.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 377

{
  "pageNumber": 1,
  "pageSize": 1,
  "orderBy": "text",
  "ascending": true,
  "filter": {
    "searchInputTextValue": "text",
    "condition": "text",
    "filterGroups": [
      {
        "condition": "text",
        "filterItems": [
          {
            "fieldName": "text",
            "operator": "text",
            "value": "text"
          }
        ],
        "filterGroups": [
          {
            "condition": "text",
            "filterItems": [
              {
                "fieldName": "text",
                "operator": "text",
                "value": "text"
              }
            ],
            "filterGroups": "[Circular Reference]"
          }
        ]
      }
    ]
  }
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

200

OK

{
  "data": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalNumberOfPages": 1,
    "totalNumberOfRecords": 1,
    "results": [
      {
        "targetUserResourceId": "text",
        "userEmail": "text",
        "sentDate": "2026-03-09T13:38:37.349Z",
        "status": "text",
        "userEmailId": "text",
        "createdDate": "2026-03-09T13:38:37.349Z",
        "userEmailSendTime": "2026-03-09T13:38:37.349Z",
        "firstSendTime": "2026-03-09T13:38:37.349Z",
        "lastSendTime": "2026-03-09T13:38:37.349Z",
        "emailDelivery": "text",
        "customFieldValues": [
          {
            "resourceId": "text",
            "name": "text",
            "dataType": "text",
            "value": "text",
            "timestampValue": "2026-03-09T13:38:37.349Z"
          }
        ]
      }
    ]
  },
  "status": "text",
  "message": "text",
  "validationMessages": [
    "text"
  ]
}

---

POST /api/training-reports/{enrollmentId}/reminder-mails/search

Returns reminder mails sent for that enrollment (e.g. training reminders). Send X-KEEPNET-Company-Id. Replace {enrollmentId} with the enrollment resourceId.

Returns reminder mails for enrollment mails. As a Reseller, send X-KEEPNET-Company-Id: <companyResourceId>.

Returns reminder mails for enrollment mails

post

Required scopes

This endpoint requires the following scopes:

• : API

Authorizations

oauth2bearerAuth

OAuth2clientCredentialsRequired

Client ID and Client Secret from Company → Company Settings → REST API. Enter credentials to auto-fetch token.

Token URL:

Path parameters

enrollmentIdstringRequired

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

trainingTypestringOptional

reportAllPagesbooleanOptional

showByExamStatusstringOptional

pageNumberinteger · int32Optional

pageSizeinteger · int32Optional

orderBystring · nullableOptional

ascendingbooleanOptional

Responses

200

OK

application/json

statusstring · nullableOptional

messagestring · nullableOptional

validationMessagesstring[] · nullableOptional

post

/api/training-reports/{enrollmentId}/reminder-mails/search

HTTPcURLJavaScriptPython

POST /api/training-reports/{enrollmentId}/reminder-mails/search HTTP/1.1
Host: api.keepnetlabs.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 447

{
  "trainingType": "text",
  "reportAllPages": true,
  "showByExamStatus": "text",
  "filter": {
    "searchInputTextValue": "text",
    "condition": "text",
    "filterGroups": [
      {
        "condition": "text",
        "filterItems": [
          {
            "fieldName": "text",
            "operator": "text",
            "value": "text"
          }
        ],
        "filterGroups": [
          {
            "condition": "text",
            "filterItems": [
              {
                "fieldName": "text",
                "operator": "text",
                "value": "text"
              }
            ],
            "filterGroups": "[Circular Reference]"
          }
        ]
      }
    ]
  },
  "pageNumber": 1,
  "pageSize": 1,
  "orderBy": "text",
  "ascending": true
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

200

OK

{
  "data": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalNumberOfPages": 1,
    "totalNumberOfRecords": 1,
    "results": [
      {
        "userEmailId": "text",
        "email": "text",
        "emailDelivery": "text",
        "firstSendDate": "2026-03-09T13:38:37.349Z",
        "lastSendDate": "2026-03-09T13:38:37.349Z",
        "lastSendingStatus": "text"
      }
    ]
  },
  "status": "text",
  "message": "text",
  "validationMessages": [
    "text"
  ]
}

---

POST /api/notifications/{enrollmentId}/search

Search notification activity logs for that enrollment (e.g. email/Teams notifications). Send X-KEEPNET-Company-Id. Replace {enrollmentId} with the enrollment resourceId.

Search notification activity logs with filtering and pagination. As a Reseller, send X-KEEPNET-Company-Id: <companyResourceId>.

Search notification activity logs with filtering and pagination

post

Required scopes

This endpoint requires the following scopes:

• : API

Authorizations

oauth2bearerAuth

OAuth2clientCredentialsRequired

Client ID and Client Secret from Company → Company Settings → REST API. Enter credentials to auto-fetch token.

Token URL:

Path parameters

enrollmentIdstringRequired

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

companyIdinteger · int32Optional

enrollmentIdstring · nullableOptional

statusstringOptional

typestringOptional

pageNumberinteger · int32Optional

pageSizeinteger · int32Optional

orderBystring · nullableOptional

ascendingbooleanOptional

Responses

200

OK

application/json

statusstring · nullableOptional

messagestring · nullableOptional

validationMessagesstring[] · nullableOptional

post

/api/notifications/{enrollmentId}/search

HTTPcURLJavaScriptPython

POST /api/notifications/{enrollmentId}/search HTTP/1.1
Host: api.keepnetlabs.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 443

{
  "companyId": 1,
  "enrollmentId": "text",
  "filter": {
    "searchInputTextValue": "text",
    "condition": "text",
    "filterGroups": [
      {
        "condition": "text",
        "filterItems": [
          {
            "fieldName": "text",
            "operator": "text",
            "value": "text"
          }
        ],
        "filterGroups": [
          {
            "condition": "text",
            "filterItems": [
              {
                "fieldName": "text",
                "operator": "text",
                "value": "text"
              }
            ],
            "filterGroups": "[Circular Reference]"
          }
        ]
      }
    ]
  },
  "status": "text",
  "type": "text",
  "pageNumber": 1,
  "pageSize": 1,
  "orderBy": "text",
  "ascending": true
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

200

OK

{
  "data": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalNumberOfPages": 1,
    "totalNumberOfRecords": 1,
    "results": [
      {
        "id": 1,
        "companyId": 1,
        "tenantId": "text",
        "targetUserId": 1,
        "tenantUserId": "text",
        "firstSendDate": "text",
        "lastSendingStatus": "text",
        "firstName": "text",
        "lastName": "text",
        "email": "text",
        "department": "text",
        "status": "text",
        "type": "text",
        "enrollmentId": "text",
        "errorMessage": "text",
        "lastSendDate": "2026-03-09T13:38:37.349Z",
        "createTime": "2026-03-09T13:38:37.349Z",
        "retryCount": 1,
        "maxRetryCount": 1,
        "trainingUrl": "text",
        "trainingTitle": "text",
        "activityContent": "text",
        "fullName": "text",
        "canResend": true
      }
    ]
  },
  "status": "text",
  "message": "text",
  "validationMessages": [
    "text"
  ]
}

---

Common errors

• 403 Forbidden — Credential is not Reseller, or the Company ID is not one you manage. Set Client Role = Reseller. Roles and permissions →

• 401 Unauthorized — Missing or invalid token. Request a new token via POST /connect/token.

• 404 Not Found / 400 Bad Request — Invalid Company ID or enrollment ID. Verify Company ID from POST /api/companies/search and enrollment ID from POST /api/enrollments/search; ensure you send X-KEEPNET-Company-Id for the customer that owns the enrollment.

Related: Scope API requests to a customer →. View customer's enrollment list and report → (list enrollments and summary). For enrollment and training endpoints: see Endpoints → Enrollment, TrainingReport in the API Reference.