Progress API: Gradebooks

Retrieves one specific gradebook

get

Authorizations

BearerCookie

BearerstringRequired

Path parameters

gradebookstring · uuidRequired

Responses

200

OK

application/jsontext/json

get

/api/progress/gradebooks/{gradebook}

HTTPcURLJavaScriptPython

GET /v2/e01/api/progress/gradebooks/{gradebook} HTTP/1.1
Bearer: YOUR_API_KEY
Accept: */*

200

OK

{
  "achievementIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "eventIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "frameworkIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "gradebookIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "organizationIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "periodIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "isLocked": true,
  "gradebookTitle": "text",
  "gradebookType": "text",
  "lastChangeType": "text",
  "lastChangeUser": "text",
  "reference": "text",
  "gradebookCreated": "2026-01-29T16:27:44.583Z",
  "lastChangeTime": "2026-01-29T16:27:44.583Z",
  "achievementTitle": "text",
  "classInstructors": "text",
  "classScheduledStartDate": "text",
  "classScheduledEndDate": "text",
  "classTitle": "text"
}

Checks for the existence of one specific gradebook

head

Authorizations

BearerCookie

BearerstringRequired

Path parameters

gradebookstring · uuidRequired

Responses

200

OK

application/jsontext/json

Responseboolean

head

/api/progress/gradebooks/{gradebook}

HTTPcURLJavaScriptPython

HEAD /v2/e01/api/progress/gradebooks/{gradebook} HTTP/1.1
Bearer: YOUR_API_KEY
Accept: */*

200

OK

true

Collects the list of gradebooks that match specific criteria

post

Authorizations

BearerCookie

BearerstringRequired

Body

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

identifierstring · uuid · nullableOptional

achievementIdentifierstring · uuid · nullableOptional

classIdentifierstring · uuid · nullableOptional

classInstructorIdentifierstring · uuid · nullableOptional

frameworkIdentifierstring · uuid · nullableOptional

organizationIdstring · uuid · nullableOptional

periodIdentifierstring · uuid · nullableOptional

isLockedboolean · nullableOptional

classTitlestring · nullableOptional

gradebookTitlestring · nullableOptional

gradebookTypestring · nullableOptional

lastChangeTypestring · nullableOptional

lastChangeUserstring · nullableOptional

referencestring · nullableOptional

classStartedSincestring · date-time · nullableOptional

classStartedBeforestring · date-time · nullableOptional

gradebookCreatedSincestring · date-time · nullableOptional

gradebookCreatedBeforestring · date-time · nullableOptional

lastChangeSincestring · date-time · nullableOptional

lastChangeBeforestring · date-time · nullableOptional

Responses

200

OK

application/jsontext/json

post

/api/progress/gradebooks/collect

HTTPcURLJavaScriptPython

POST /v2/e01/api/progress/gradebooks/collect HTTP/1.1
Bearer: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 1241

{
  "identifier": "123e4567-e89b-12d3-a456-426614174000",
  "origin": {
    "when": "2026-01-29T16:27:44.583Z",
    "organization": "123e4567-e89b-12d3-a456-426614174000",
    "user": "123e4567-e89b-12d3-a456-426614174000",
    "proxy": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "reason": "text",
    "source": "text"
  },
  "filter": {
    "page": 1,
    "pageSize": 1,
    "sort": "text",
    "excludes": "text",
    "includes": "text",
    "format": "text"
  },
  "texts": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "achievementIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "classIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "classInstructorIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "frameworkIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "periodIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "isLocked": true,
  "classTitle": "text",
  "gradebookTitle": "text",
  "gradebookType": "text",
  "lastChangeType": "text",
  "lastChangeUser": "text",
  "reference": "text",
  "classStartedSince": "2026-01-29T16:27:44.583Z",
  "classStartedBefore": "2026-01-29T16:27:44.583Z",
  "gradebookCreatedSince": "2026-01-29T16:27:44.583Z",
  "gradebookCreatedBefore": "2026-01-29T16:27:44.583Z",
  "lastChangeSince": "2026-01-29T16:27:44.583Z",
  "lastChangeBefore": "2026-01-29T16:27:44.583Z"
}

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

200

OK

[
  {
    "achievementIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "eventIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "frameworkIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "gradebookIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "organizationIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "periodIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "isLocked": true,
    "gradebookTitle": "text",
    "gradebookType": "text",
    "lastChangeType": "text",
    "lastChangeUser": "text",
    "reference": "text",
    "gradebookCreated": "2026-01-29T16:27:44.583Z",
    "lastChangeTime": "2026-01-29T16:27:44.583Z",
    "achievementTitle": "text",
    "classInstructors": "text",
    "classScheduledStartDate": "text",
    "classScheduledEndDate": "text",
    "classTitle": "text"
  }
]

Counts the gradebooks that match specific criteria

post

Authorizations

BearerCookie

BearerstringRequired

Body

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

identifierstring · uuid · nullableOptional

achievementIdentifierstring · uuid · nullableOptional

classIdentifierstring · uuid · nullableOptional

classInstructorIdentifierstring · uuid · nullableOptional

frameworkIdentifierstring · uuid · nullableOptional

organizationIdstring · uuid · nullableOptional

periodIdentifierstring · uuid · nullableOptional

isLockedboolean · nullableOptional

classTitlestring · nullableOptional

gradebookTitlestring · nullableOptional

gradebookTypestring · nullableOptional

lastChangeTypestring · nullableOptional

lastChangeUserstring · nullableOptional

referencestring · nullableOptional

classStartedSincestring · date-time · nullableOptional

classStartedBeforestring · date-time · nullableOptional

gradebookCreatedSincestring · date-time · nullableOptional

gradebookCreatedBeforestring · date-time · nullableOptional

lastChangeSincestring · date-time · nullableOptional

lastChangeBeforestring · date-time · nullableOptional

Responses

200

OK

application/jsontext/json

post

/api/progress/gradebooks/count

HTTPcURLJavaScriptPython

POST /v2/e01/api/progress/gradebooks/count HTTP/1.1
Bearer: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 1241

{
  "identifier": "123e4567-e89b-12d3-a456-426614174000",
  "origin": {
    "when": "2026-01-29T16:27:44.583Z",
    "organization": "123e4567-e89b-12d3-a456-426614174000",
    "user": "123e4567-e89b-12d3-a456-426614174000",
    "proxy": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "reason": "text",
    "source": "text"
  },
  "filter": {
    "page": 1,
    "pageSize": 1,
    "sort": "text",
    "excludes": "text",
    "includes": "text",
    "format": "text"
  },
  "texts": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "achievementIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "classIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "classInstructorIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "frameworkIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "periodIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "isLocked": true,
  "classTitle": "text",
  "gradebookTitle": "text",
  "gradebookType": "text",
  "lastChangeType": "text",
  "lastChangeUser": "text",
  "reference": "text",
  "classStartedSince": "2026-01-29T16:27:44.583Z",
  "classStartedBefore": "2026-01-29T16:27:44.583Z",
  "gradebookCreatedSince": "2026-01-29T16:27:44.583Z",
  "gradebookCreatedBefore": "2026-01-29T16:27:44.583Z",
  "lastChangeSince": "2026-01-29T16:27:44.583Z",
  "lastChangeBefore": "2026-01-29T16:27:44.583Z"
}

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

200

OK

{
  "count": 1,
  "summary": "text"
}

Downloads the list of gradebooks that match specific criteria

post

Authorizations

BearerCookie

BearerstringRequired

Body

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

identifierstring · uuid · nullableOptional

achievementIdentifierstring · uuid · nullableOptional

classIdentifierstring · uuid · nullableOptional

classInstructorIdentifierstring · uuid · nullableOptional

frameworkIdentifierstring · uuid · nullableOptional

organizationIdstring · uuid · nullableOptional

periodIdentifierstring · uuid · nullableOptional

isLockedboolean · nullableOptional

classTitlestring · nullableOptional

gradebookTitlestring · nullableOptional

gradebookTypestring · nullableOptional

lastChangeTypestring · nullableOptional

lastChangeUserstring · nullableOptional

referencestring · nullableOptional

classStartedSincestring · date-time · nullableOptional

classStartedBeforestring · date-time · nullableOptional

gradebookCreatedSincestring · date-time · nullableOptional

gradebookCreatedBeforestring · date-time · nullableOptional

lastChangeSincestring · date-time · nullableOptional

lastChangeBeforestring · date-time · nullableOptional

Responses

200

OK

No content

post

/api/progress/gradebooks/download

HTTPcURLJavaScriptPython

POST /v2/e01/api/progress/gradebooks/download HTTP/1.1
Bearer: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 1241

{
  "identifier": "123e4567-e89b-12d3-a456-426614174000",
  "origin": {
    "when": "2026-01-29T16:27:44.583Z",
    "organization": "123e4567-e89b-12d3-a456-426614174000",
    "user": "123e4567-e89b-12d3-a456-426614174000",
    "proxy": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "reason": "text",
    "source": "text"
  },
  "filter": {
    "page": 1,
    "pageSize": 1,
    "sort": "text",
    "excludes": "text",
    "includes": "text",
    "format": "text"
  },
  "texts": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "achievementIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "classIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "classInstructorIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "frameworkIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "periodIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "isLocked": true,
  "classTitle": "text",
  "gradebookTitle": "text",
  "gradebookType": "text",
  "lastChangeType": "text",
  "lastChangeUser": "text",
  "reference": "text",
  "classStartedSince": "2026-01-29T16:27:44.583Z",
  "classStartedBefore": "2026-01-29T16:27:44.583Z",
  "gradebookCreatedSince": "2026-01-29T16:27:44.583Z",
  "gradebookCreatedBefore": "2026-01-29T16:27:44.583Z",
  "lastChangeSince": "2026-01-29T16:27:44.583Z",
  "lastChangeBefore": "2026-01-29T16:27:44.583Z"
}

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

200

OK

No content

Searches for the list of gradebooks that match specific criteria

post

Authorizations

BearerCookie

BearerstringRequired

Body

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

identifierstring · uuid · nullableOptional

organizationIdstring · uuid · nullableOptional

gradebookTitlestring · nullableOptional

gradebookCreatedSincestring · date-time · nullableOptional

gradebookCreatedBeforestring · date-time · nullableOptional

periodIdentifierstring · uuid · nullableOptional

achievementIdentifierstring · uuid · nullableOptional

frameworkIdentifierstring · uuid · nullableOptional

isLockedboolean · nullableOptional

classTitlestring · nullableOptional

classStartedSincestring · date-time · nullableOptional

classStartedBeforestring · date-time · nullableOptional

classInstructorIdentifierstring · uuid · nullableOptional

classIdentifierstring · uuid · nullableOptional

gradebookTypestring · nullableOptional

lastChangeTypestring · nullableOptional

lastChangeUserstring · nullableOptional

referencestring · nullableOptional

lastChangeSincestring · date-time · nullableOptional

lastChangeBeforestring · date-time · nullableOptional

Responses

200

OK

application/jsontext/json

post

/api/progress/gradebooks/search

HTTPcURLJavaScriptPython

POST /v2/e01/api/progress/gradebooks/search HTTP/1.1
Bearer: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 1241

{
  "identifier": "123e4567-e89b-12d3-a456-426614174000",
  "origin": {
    "when": "2026-01-29T16:27:44.583Z",
    "organization": "123e4567-e89b-12d3-a456-426614174000",
    "user": "123e4567-e89b-12d3-a456-426614174000",
    "proxy": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "reason": "text",
    "source": "text"
  },
  "filter": {
    "page": 1,
    "pageSize": 1,
    "sort": "text",
    "excludes": "text",
    "includes": "text",
    "format": "text"
  },
  "texts": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "gradebookTitle": "text",
  "gradebookCreatedSince": "2026-01-29T16:27:44.583Z",
  "gradebookCreatedBefore": "2026-01-29T16:27:44.583Z",
  "periodIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "achievementIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "frameworkIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "isLocked": true,
  "classTitle": "text",
  "classStartedSince": "2026-01-29T16:27:44.583Z",
  "classStartedBefore": "2026-01-29T16:27:44.583Z",
  "classInstructorIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "classIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "gradebookType": "text",
  "lastChangeType": "text",
  "lastChangeUser": "text",
  "reference": "text",
  "lastChangeSince": "2026-01-29T16:27:44.583Z",
  "lastChangeBefore": "2026-01-29T16:27:44.583Z"
}

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

200

OK

[
  {
    "gradebookIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "gradebookTitle": "text",
    "gradebookCreated": "2026-01-29T16:27:44.583Z",
    "gradebookEnrollmentCount": 1,
    "classIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "classTitle": "text",
    "classStarted": "2026-01-29T16:27:44.583Z",
    "classEnded": "2026-01-29T16:27:44.583Z",
    "achievementIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "achievementTitle": "text",
    "achievementCountGranted": 1,
    "isLocked": true
  }
]

get

DO NOT use allow this endpoint to be used in live Production environments. When time and budget permit, we will design and implement a fire-and-forget strategy managing a queue of large exports, reports, etc.

Authorizations

BearerCookie

BearerstringRequired

Query parameters

AchievementIdentifierstring · uuidOptional

ClassIdentifierstring · uuidOptional

ClassInstructorIdentifierstring · uuidOptional

FrameworkIdentifierstring · uuidOptional

OrganizationIdstring · uuidOptional

PeriodIdentifierstring · uuidOptional

IsLockedbooleanOptional

ClassTitlestringOptional

GradebookTitlestringOptional

GradebookTypestringOptional

LastChangeTypestringOptional

LastChangeUserstringOptional

ReferencestringOptional

ClassStartedSincestring · date-timeOptional

ClassStartedBeforestring · date-timeOptional

GradebookCreatedSincestring · date-timeOptional

GradebookCreatedBeforestring · date-timeOptional

LastChangeSincestring · date-timeOptional

LastChangeBeforestring · date-timeOptional

Identifierstring · uuidOptional

Origin.Whenstring · date-timeOptional

Origin.Organizationstring · uuidOptional

Origin.Userstring · uuidOptional

Origin.Proxystring · uuidOptional

Origin.DescriptionstringOptional

Origin.ReasonstringOptional

Origin.SourcestringOptional

Filter.Pageinteger · int32Optional

Filter.PageSizeinteger · int32Optional

Filter.SortstringOptional

Filter.ExcludesstringOptional

Filter.IncludesstringOptional

Filter.FormatstringOptional

Responses

200

OK

application/jsontext/json

get

/api/progress/gradebooks/export

HTTPcURLJavaScriptPython

GET /v2/e01/api/progress/gradebooks/export HTTP/1.1
Bearer: YOUR_API_KEY
Accept: */*

200

OK

{
  "downloadUrl": "text",
  "exportFormat": "text",
  "exportKey": "text",
  "expiry": "2026-01-29T16:27:44.583Z"
}

get

Authorizations

BearerCookie

BearerstringRequired

Path parameters

keystringRequired

Responses

200

OK

No content

get

/api/progress/gradebooks/exports/{key}

HTTPcURLJavaScriptPython

GET /v2/e01/api/progress/gradebooks/exports/{key} HTTP/1.1
Bearer: YOUR_API_KEY
Accept: */*

200

OK

No content