Search for a class enrollment
    • 16 Jul 2024
    • 4 Minutes to read

    Search for a class enrollment


    Article summary

    Get
    /SearchClassEnrollments

    Allows you to search for a class enrollment.

    Security
    API Key
    Header parameter nameapi_key
    Query parameters
    pageIndex
    integer (int32)

    A 0-based index of the paged results you wish to receive. In general, you should start with a value of zero and increment it as you need to retrieve additional results. If not supplied, a value of 0 is used (the first page of results).

    pageSize
    integer (int32)

    Indicates how many results you want per page. if not supplied, a default value of 100 is used.

    sort
    string

    The value you want to sort by. If not supplied, a default value of "Name" will be used. You can append " DESC" after the sort value to sort descending. For example, "Name DESC" would sort by name in descending order. Possible values:

    • Name
    • Program
    • CompanyOrganization
    • Owner
    • Company
    • Starts
    • Expires
    • Size
    • Used
    • Created
    • LastModified
    className
    string

    An optional parameter used to filter for class enrollments by class name. When specified, only class enrollments that have names that contain or match this value will be returned.

    classId
    integer (int32)

    An optional parameter used to filter for class enrollments by classid. When specified, only class enrollments that have an associated class with that Id will be returned.

    studentId
    integer (int32)

    An optional parameter used to filter for class enrollments by the associated student's ID. When specified, only class enrollments that have an associated student with that Id will be returned.

    enrollmentStatusId
    integer (int32)

    An optional parameter used to filter for class enrollments based on the status of the class enrollment

    • 0 = Request
    • 10 = Cancel
    • 20 = Waitlist
    • 30 = Approve
    • 40 = Deny
    • 50 = Audit
    • 60 = Enroll
    createdAfter
    integer (int32)

    An optional parameter used to filter for class enrollments created after a specified date. When used in conjunction with the "createdBefore" parameter, it becomes possible to filter for a given time range. This should be provided in unix epoch format, which is the number of seconds that have elapsed since midnight UTC January 1st, 1970.

    createdBefore
    integer (int32)

    An optional parameter used to filter for class enrollments created before a specified date. When used in conjunction with the "createdAfter" parameter, it becomes possible to filter for a given time range. This should be provided in unix epoch format, which is the number of seconds that have elapsed since midnight UTC January 1st, 1970.

    lastModifiedAfter
    integer (int32)

    An optional parameter used to filter for class enrollments updated after a specified date. When used in conjunction with the "lastModifiedBefore" parameter, it becomes possible to filter for a given time range. This should be provided in unix epoch format, which is the number of seconds that have elapsed since midnight UTC January 1st, 1970.

    lastModifiedBefore
    integer (int32)

    An optional parameter used to filter for class enrollments updated before a specified date. When used in conjunction with the "lastModifiedAfter" parameter, it becomes possible to filter for a given time range. This should be provided in unix epoch format, which is the number of seconds that have elapsed since midnight UTC January 1st, 1970.

    Responses
    200

    OK Response

    Expand All
    object
    Status
    integer (int32)

    Indicates the status of the API request.

    0 = Success
    10 = Error
    20 = Not found
    30 = Invalid integration key

    Example10
    Error
    string | null

    Error details. This will only have a value if an error was encountered. The status property will also be set to Error (10).

    TotalCount
    integer (int32)

    The total number of results that match the search conditions, not all of which may be in the current result set.

    Example1
    TotalPages
    integer (int32)

    The total number of result pages that match the search conditions.

    Example1
    Results
    Array of object (ClassEnrollmentSearch)

    See ClassEnrollment

    object
    Id
    integer (int32)

    The class enrollment's unique identifier

    Example10
    ExternalId
    string | null

    The class enrollment's external ID, usually a unique identifier from the calling system

    ExampleE3G5YZFREFEQ9371
    UserId
    integer (int32)

    The Id of the related user

    Example897615
    UserExternalId
    integer (int32)

    The external Id of the related user

    Example897615
    ClassId
    integer (int32)

    The Id of the related class

    Example4421
    ClassName
    string

    The name of the class

    ExampleClass name sample
    ClassExternalId
    integer (int32)

    The external Id of the related class

    Example4421
    EnrollmentStatusId
    integer (int32)

    Indicates the status of the class enrollment

    • 0 = Request
    • 10 = Cancel
    • 20 = Waitlist
    • 30 = Approve
    • 40 = Deny
    • 50 = Audit
    • 60 = Enroll
    Example60
    CompletionStatusId
    integer (int32)

    Indicates the completion status of the class enrollment

    • 0 = Unknown
    • 10 = Attending
    • 20 = Complete
    • 30 = Incomplete
    • 40 = NoShow
    • 50 = Failed
    Example0
    LateCancel
    boolean

    Indicates if the class enrollment was cancelled outside the late cancellation window.

    ExampleFalse
    Retake
    boolean

    Indicates if the class enrollment is a retake.

    ExampleFalse
    LocationTypeId
    integer (int32) | null

    Indicates the location type that the student is assigned to attend the class

    • 0 = To Be Determined
    • 10 = Classroom
    • 20 = Remote Classroom
    • 30 = Virtual
    Example0
    ClassroomId
    integer (int32) | null

    The ID of the classroom (if any) in which the student is assigned to attend the class.

    Example3456
    HoursSpent
    integer (int32) | null

    The hours spent by the student in the class enrollment.

    Example20
    Grade
    integer (int32) | null

    The grade the student received for the class enrollment.

    Example10
    LastModified
    integer (int64)

    When the class enrollment was last modified. Provided in Unix epoch format, which is the number of seconds that have elapsed since midnight UTC January 1st, 1970.

    Example1295375536

    Was this article helpful?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.