Get Enrollment Details

Admin Enrollments (0.0.1)

Overview

The Admin Enrollment REST API provides administrative capabilities for managing and monitoring user enrollments and device registrations within RUCKUS One platform. These APIs enable administrators to query enrollment records, view registration details, and track enrollment activities across the organization. Use these endpoints to retrieve enrollment information, search registrations by various criteria, and monitor the overall enrollment workflow status.

Download OpenAPI description

Download PDF

Overview

License

RUCKUS Cloud Privacy Policy

Servers

RUCKUS One API host for North American region.

https://api.ruckus.cloud

RUCKUS One API host for European region.

https://api.eu.ruckus.cloud

RUCKUS One API host for Asian region.

https://api.asia.ruckus.cloud

Admin Enrollment Registration API

Manages enrollment registration admin views.

Operations

Admin Enrollment API

Manages enrollment admin views.

Operations

Query Enrollments

Request

Gets the list of enrollments using the specified query.

Body

Search criteria and pagination details

sortDirectionstring

Sort direction for ordering query results in ascending or descending order.

Enum"ASC""DESC"

pageinteger(int32)

Page number. If not specified the first page will be returned.

pageSizeinteger(int32)

Number of records in a page.If not specified default page size of 20 will be applied.

workflowIdstring(uuid)

Identifier of the workflow.

enrollmentIdstring(uuid)

Identifier of the enrollment.

descriptionstring[ 0 .. 1000 ] characters

Description of the enrollment.

macAddressstring^([0-9A-Fa-f]{2}-){5}([0-9A-Fa-f]{2})$|^([0-9...

Mac address of the enrolled device.

ipAddressstring(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25...

Network address of the enrolled device.

statusstring

Enrollment status.

Enum"CREATED""STARTED""FINISHED""ABANDONED""ACTIVE""INACTIVE""REVOKED"

sortFieldsArray of strings

List of field names used to sort the enrollment query results.

{
  "sortDirection": "ASC",
  "page": 0,
  "pageSize": 0,
  "workflowId": "43c4fa9b-0cbc-4b57-a121-9d7d46a3eaa4",
  "enrollmentId": "883e2903-3e2f-407c-ae2a-1274a4137945",
  "description": "string",
  "macAddress": "string",
  "ipAddress": "string",
  "status": "CREATED",
  "sortFields": "workflowId"
}

Responses

Body

totalPagesinteger(int32)

Total number of pages available in the paginated result set.

totalElementsinteger(int64)

Total number of enrollment elements across all pages.

firstboolean

Indicates whether this is the first page in the paginated result set.

lastboolean

Indicates whether this is the last page in the paginated result set.

sizeinteger(int32)

contentArray of objects(EntityModelEnrollmentDto)

List of enrollment items on the current page.

numberinteger(int32)

Current page number (zero indexed).

sortobject(SortObject)

Sorting information object containing sort order and field details.

pageableobject(PageableObject)

Pagination information including page number, size, and sort details.

numberOfElementsinteger(int32)

Number of elements on the current page.

emptyboolean

Indicates whether the current page contains any elements.

Response

{
  "totalPages": 0,
  "totalElements": 0,
  "first": true,
  "last": true,
  "size": 0,
  "content": [
    { … }
  ],
  "number": 0,
  "sort": {
    "empty": true,
    "sorted": true,
    "unsorted": true
  },
  "pageable": {
    "offset": 0,
    "sort": { … },
    "paged": true,
    "pageNumber": 0,
    "pageSize": 0,
    "unpaged": true
  },
  "numberOfElements": 0,
  "empty": true
}

Get Enrollment Details

Request

Gets enrollment details for the requested enrollment identifier.

Path

enrollmentIdstringnon-emptyrequired

Enrollment Id

No request payload

Responses

Body

workflowIdstring(uuid)

Identifier of the workflow.

enrollmentIdstring(uuid)

Identifier of the enrollment.

descriptionstring[ 0 .. 1000 ] characters

Description of the enrollment.

macAddressstring^([0-9A-Fa-f]{2}-){5}([0-9A-Fa-f]{2})$|^([0-9...

Mac address of the enrolled device.

ipAddressstring(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25...

Network address of the enrolled device.

statusstring

Enrollment status.

Enum"CREATED""STARTED""FINISHED""ABANDONED""ACTIVE""INACTIVE""REVOKED"

userAgentNamestring

Name of the user agent that initiated the enrollment process.

variablesArray of objects(EnrollmentVariableDto)

List of enrollment variables containing key and value pairs for enrollment configuration.

_linksobject(Links)

Response

{
  "workflowId": "43c4fa9b-0cbc-4b57-a121-9d7d46a3eaa4",
  "enrollmentId": "883e2903-3e2f-407c-ae2a-1274a4137945",
  "description": "string",
  "macAddress": "string",
  "ipAddress": "string",
  "status": "CREATED",
  "userAgentName": "string",
  "variables": [
    { … }
  ],
  "_links": {
    "property1": { … },
    "property2": { … }
  }
}