View customer's enrollment list and report

As a Reseller you can list a customer's enrollments (training or survey), get details and summary reports, and pull the Users report for an enrollment so you have per-user data for custom reporting. Use a credential with Client Role = Reseller. Send X-KEEPNET-Company-Id (and for enrollment search, x-ir-company-id with the same value) so results are scoped to that customer.

---

Get the customer's Company ID

Endpoint: POST /api/companies/search

Use the resourceId of the desired company as the Company ID in the enrollment and report requests below.

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 in the Endpoints panel, 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-09T17:38:22.919Z",
        "createTime": "2026-03-09T17:38:22.919Z",
        "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-09T17:38:22.919Z",
            "createTime": "2026-03-09T17:38:22.919Z",
            "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 (e.g. by companyName) and note its companyResourceId. Use that value in the X-KEEPNET-Company-Id and x-ir-company-id headers in the next steps.

---

List enrollments for the customer

Endpoint: POST /api/enrollments/search

Returns a paginated list of enrollments for that customer. Send the Company ID in both X-KEEPNET-Company-Id and x-ir-company-id so the list is scoped to the chosen company. The response includes enrollmentId, name, type (e.g. "Survey" or training type), status, and other fields — use enrollmentId when calling the report endpoints below.

Returns a list of enrollments. As a Reseller, send X-KEEPNET-Company-Id: <companyResourceId> and x-ir-company-id: <companyResourceId> with the same customer Company ID.

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-09T17:38:22.919Z",
        "trainingName": "text",
        "delivery": "text",
        "deliveryType": "text",
        "createTime": "2026-03-09T17:38:22.919Z",
        "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"
  ]
}

Example headers:

Authorization: Bearer <your_access_token>
Content-Type: application/json
X-KEEPNET-Company-Id: xC5kfGz7w2Nz
x-ir-company-id: xC5kfGz7w2Nz

Example body (first page; filter structure required):

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

From the response, use enrollmentId (or resourceId) of the enrollment you want to report on.

---

List only Survey enrollments

To restrict the list to Survey enrollments (e.g. security culture surveys), add enrollmentType to the request body and use the same filter structure as above:

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

Each result includes "type": "Survey", name, enrollmentId, and delivery info. Use that enrollmentId for the summary and Users report endpoints below.

---

Get enrollment details

Endpoint: GET /api/enrollments/{resourceId}

Returns full details for one enrollment. Send X-KEEPNET-Company-Id with the customer's Company ID.

Get enrollment by Id. As a Reseller, send X-KEEPNET-Company-Id: <companyResourceId> for the customer that owns this enrollment.

Get enrollment by Id

get

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

resourceIdstringRequired

Responses

200

OK

application/json

statusstring · nullableOptional

messagestring · nullableOptional

validationMessagesstring[] · nullableOptional

get

/api/enrollments/{resourceId}

HTTPcURLJavaScriptPython

GET /api/enrollments/{resourceId} HTTP/1.1
Host: api.keepnetlabs.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

200

OK

{
  "data": {
    "trainingId": "text",
    "name": "text",
    "learningPathId": "text",
    "trainingOrder": 1,
    "targetGroupResourceIds": [
      "text"
    ],
    "phishingCampaignResourceId": "text",
    "phishingCampaignConditionTypes": [
      "text"
    ],
    "languageIds": [
      "text"
    ],
    "enrollmentScheduler": {
      "scheduledDate": "2026-03-09T17:38:22.919Z",
      "scheduledTimeZoneId": "text",
      "useOwnTimeZone": true,
      "dueDate": "2026-03-09T17:38:22.919Z"
    },
    "enrollmentReminder": {
      "periodCount": 1,
      "periodType": "text",
      "endType": "text",
      "occurrenceCount": 1,
      "stopTime": "2026-03-09T17:38:22.919Z"
    },
    "enrollmentAutoEnroll": {
      "type": "text",
      "dayOfWeek": 1,
      "emailPeriodTypeEnum": "text",
      "periodCount": 1
    },
    "smsTexts": [
      {
        "type": "text",
        "providerNumberResourceId": "text",
        "template": "text"
      }
    ],
    "awardCertificate": true,
    "certificateConfigSendType": "text",
    "markedAsTest": true,
    "trainingTypeId": "text",
    "distributionDays": 1
  },
  "status": "text",
  "message": "text",
  "validationMessages": [
    "text"
  ]
}

---

Get enrollment summary report

Endpoint: GET /api/training-reports/{enrollmentId}/summary

Returns the enrollment summary (overview). Send X-KEEPNET-Company-Id. For Survey enrollments, you can pass the optional query parameter trainingType=0.

Returns enrollment summary report. As a Reseller, send X-KEEPNET-Company-Id: <companyResourceId>.

Returns enrollment summary report

get

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

Query parameters

trainingTypestringOptional

Responses

200

OK

application/json

statusstring · nullableOptional

messagestring · nullableOptional

validationMessagesstring[] · nullableOptional

get

/api/training-reports/{enrollmentId}/summary

HTTPcURLJavaScriptPython

GET /api/training-reports/{enrollmentId}/summary HTTP/1.1
Host: api.keepnetlabs.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

200

OK

{
  "data": {
    "trainingDetails": {
      "id": "text",
      "name": "text",
      "description": "text",
      "companyName": "text",
      "category": "text",
      "trainingTypeName": "text",
      "hasQuiz": true
    },
    "reportDetail": {
      "totalUserOpenedCount": 1,
      "totalTargetUserCount": 1,
      "onlyOpenedCount": 1,
      "totalNonTargetUserCount": 1,
      "emailDeliveredUserCount": 1,
      "emailErrorUserCount": 1,
      "noResponseCount": 1,
      "didNotCompleteTrainingCount": 1,
      "didNotCompleteExamCount": 1,
      "failedExamCount": 1
    },
    "startDate": "2026-03-09T17:38:22.919Z",
    "name": "text",
    "completedCount": 1,
    "inProgressCount": 1,
    "groupCount": 1,
    "targetGroupNames": [
      "text"
    ],
    "languages": [
      "text"
    ],
    "reminderDescription": "text",
    "autoEnrollDescription": "text",
    "reminderSettings": {
      "periodCount": 1,
      "periodType": "text",
      "endType": "text",
      "occurrenceCount": 1,
      "stopTime": "2026-03-09T17:38:22.919Z"
    },
    "autoEnrollSettings": {
      "type": "text",
      "dayOfWeek": 1,
      "emailPeriodTypeEnum": "text",
      "periodCount": 1
    },
    "trainingEmailNotificationTemplateTypeResourceId": "text",
    "certificateEmailNotificationTemplateTypeResourceId": "text",
    "certificateAttachmentResourceId": "text",
    "isTest": true,
    "isScormProxy": true,
    "smsSummary": {
      "providerNumberResourceId": "text",
      "smsPhoneNumber": "text",
      "template": "text",
      "sentCount": 1
    },
    "trainingTypeId": "text",
    "trainingTypeName": "text",
    "steps": [
      {
        "stepNumber": 1,
        "enrollmentId": "text",
        "trainingName": "text",
        "awardCertificate": true,
        "reportDetail": {
          "totalUserOpenedCount": 1,
          "totalTargetUserCount": 1,
          "onlyOpenedCount": 1,
          "totalNonTargetUserCount": 1,
          "emailDeliveredUserCount": 1,
          "emailErrorUserCount": 1,
          "noResponseCount": 1,
          "didNotCompleteTrainingCount": 1,
          "didNotCompleteExamCount": 1,
          "failedExamCount": 1
        },
        "trainingDetails": {
          "id": "text",
          "name": "text",
          "description": "text",
          "companyName": "text",
          "category": "text",
          "trainingTypeName": "text",
          "hasQuiz": true
        }
      }
    ],
    "distributionDescription": "text",
    "deliveryMethod": "text",
    "sendTemplatesInPreferredLanguage": true
  },
  "status": "text",
  "message": "text",
  "validationMessages": [
    "text"
  ]
}

---

Pull Users report for an enrollment

Endpoint: POST /api/training-reports/{enrollmentId}/users/search

Returns the per-user training (or survey) report for that enrollment — one row per user with status, progress, and related fields. Use this to collect all users' data for a given enrollment (e.g. for custom reporting). Send X-KEEPNET-Company-Id and paginate with pageNumber / pageSize until you have all rows.

Returns target user training report for an enrollment. As a Reseller, send X-KEEPNET-Company-Id: <companyResourceId>. Request body: filter (required), pageNumber, pageSize, orderBy, ascending; for Survey enrollments include trainingType (e.g. 0) in the body. See Endpoints → TrainingReport for the full schema.

Returns target user 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

pageNumberintegerRequiredExample: 1

pageSizeintegerRequiredExample: 100

orderBystringRequiredExample: Email

ascendingbooleanRequiredExample: true

trainingTypeinteger · nullableOptional

Optional: e.g. 0 for Survey enrollment

Responses

200

OK

application/json

statusstring · nullableOptional

messagestring · nullableOptional

validationMessagesstring[] · nullableOptional

post

/api/training-reports/{enrollmentId}/users/search

HTTPcURLJavaScriptPython

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

{
  "pageNumber": 1,
  "pageSize": 100,
  "orderBy": "Email",
  "ascending": true,
  "filter": {
    "condition": "and",
    "searchInputTextValue": null,
    "filterGroups": []
  }
}

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

200

OK

{
  "data": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalNumberOfPages": 1,
    "totalNumberOfRecords": 1,
    "results": [
      {
        "firstCompletionDate": "2026-03-09T17:38:22.919Z",
        "lastInteractionDate": "2026-03-09T17:38:22.919Z",
        "deliveryType": "text",
        "phoneNumber": "text",
        "currentStep": "text",
        "status": "text",
        "examStatusName": "text",
        "examScore": 1,
        "lastInteractedStep": "text",
        "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-09T17:38:22.919Z"
          }
        ]
      }
    ]
  },
  "status": "text",
  "message": "text",
  "validationMessages": [
    "text"
  ]
}

Example body (first page; filter with condition and filterGroups as required by the schema):

{
  "pageNumber": 1,
  "pageSize": 100,
  "orderBy": "Email",
  "ascending": true,
  "filter": {
    "condition": "and",
    "searchInputTextValue": null,
    "filterGroups": []
  }
}

For Survey enrollments, add trainingType to the body (value depends on API; e.g. 0 for Survey). Paginate until results is empty or totalNumberOfRecords is reached.

---

Export the enrollment list

Endpoint: POST /api/enrollments/search/export

Export the enrollment list (e.g. CSV/Excel) for that customer. Send the same X-KEEPNET-Company-Id and a body similar to search (filter, exportType, etc.). See Endpoints → Enrollment for the full request schema.

Exports the list of enrollments. As a Reseller, send X-KEEPNET-Company-Id: <companyResourceId>.

Exports the list of 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:

Body

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

pageNumberintegerRequiredExample: 1

pageSizeintegerRequiredExample: 20

orderBystringRequiredExample: CreateTime

ascendingbooleanRequiredExample: false

reportAllPagesbooleanOptionalExample: false

exportTypestringRequiredExample: CSV

enrollmentTypestringOptional

Optional: e.g. Survey

Responses

200

OK

No content

post

/api/enrollments/search/export

HTTPcURLJavaScriptPython

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

{
  "pageNumber": 1,
  "pageSize": 20,
  "orderBy": "CreateTime",
  "ascending": false,
  "filter": {
    "condition": "and",
    "searchInputTextValue": null,
    "filterGroups": []
  },
  "reportAllPages": false,
  "exportType": "CSV"
}

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

200

OK

No content

---

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.

• 400 Bad Request — Invalid request body. For POST /api/enrollments/search, ensure filter is sent with the structure above (e.g. Condition, FilterGroups). For Survey-only results, include enrollmentType: "Survey".

• 404 Not Found — Invalid Company ID or enrollment ID. Verify Company ID from POST /api/companies/search and enrollment ID from POST /api/enrollments/search; send X-KEEPNET-Company-Id (and for enrollment search x-ir-company-id) for the customer that owns the enrollment.

Related: Scope API requests to a customer →. For training report and enrollment schemas: Endpoints → Enrollment, TrainingReport in the API Reference sidebar.