Get progress for a user on a content block

Returns a user’s progress on a content block. Scoped to your integration’s institution via Basic Auth credentials.

GET/content-blocks/{id}/progress/{userId}

Authorization

AuthorizationBasic auth · headerrequired

Basic Auth with clientId as username and clientSecret as password

Path parameters

idstringrequired

Content block ID

userIdstringrequired

User ID

Responses

200

Progress details

dataBlockProgressDetailrequired

Show properties

blockIdstringrequired

userIdstringrequired

statusstringrequired

Allowed:NOT_STARTEDIN_PROGRESSFINISHEDREVIEWED

lockStatestringrequired

Allowed:UNLOCKEDBLOCKED

startedAtstring<date-time> | nullrequired

completedAtstring<date-time> | nullrequired

userDataobject

conditionsConditionStatus[]required

Show properties

Array of ConditionStatus

conditionIdstringrequired

requiredBlockIdstringrequired

requiredBlockNamestringrequired

metbooleanrequired

metaResponseMetarequired

Show properties

requestIdstringrequired

timestampstring<date-time>required

versionstringrequired

Allowed:v4

watermarkstring<date-time>

Present on GET /users?updatedSince= pages. Taken at the first page minus a 60s overlap. Bound into pagination.next_cursor. Use it as the next updatedSince after deduping by user id. Delivery is inclusive >= and at-least-once.

401

Unauthorized

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedidempotency_key_in_progressservice_unavailableretryablerate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

existingUserIdstring

Present on 409 email or membership-code conflicts. The user id that already holds the email or code.

activeSessionobject

Present on time-tracking start 409 when a session is already running. Stop this session, then retry start.

Show properties

idstringrequired

startTimestring<date-time>required

conflictingLogobject

Present on time-tracking 409 when the interval being written overlaps an existing log or open session. Start uses [punch, ∞). Stop uses [sessionStart, stop). endTime is null while that session is still open.

Show properties

idstringrequired

startTimestring<date-time>required

endTimestring<date-time> | nullrequired

403

Forbidden

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedidempotency_key_in_progressservice_unavailableretryablerate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

existingUserIdstring

Present on 409 email or membership-code conflicts. The user id that already holds the email or code.

activeSessionobject

Present on time-tracking start 409 when a session is already running. Stop this session, then retry start.

Show properties

idstringrequired

startTimestring<date-time>required

conflictingLogobject

Show properties

idstringrequired

startTimestring<date-time>required

endTimestring<date-time> | nullrequired

404

Not Found

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedidempotency_key_in_progressservice_unavailableretryablerate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

existingUserIdstring

Present on 409 email or membership-code conflicts. The user id that already holds the email or code.

activeSessionobject

Present on time-tracking start 409 when a session is already running. Stop this session, then retry start.

Show properties

idstringrequired

startTimestring<date-time>required

conflictingLogobject

Show properties

idstringrequired

startTimestring<date-time>required

endTimestring<date-time> | nullrequired

429

Too Many Requests — 1000 requests per minute per institution. Includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (ISO-8601), and Retry-After (seconds).

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedidempotency_key_in_progressservice_unavailableretryablerate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

existingUserIdstring

Present on 409 email or membership-code conflicts. The user id that already holds the email or code.

activeSessionobject

Present on time-tracking start 409 when a session is already running. Stop this session, then retry start.

Show properties

idstringrequired

startTimestring<date-time>required

conflictingLogobject

Show properties

idstringrequired

startTimestring<date-time>required

endTimestring<date-time> | nullrequired

500

Internal Server Error

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedidempotency_key_in_progressservice_unavailableretryablerate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

existingUserIdstring

Present on 409 email or membership-code conflicts. The user id that already holds the email or code.

activeSessionobject

Present on time-tracking start 409 when a session is already running. Stop this session, then retry start.

Show properties

idstringrequired

startTimestring<date-time>required

conflictingLogobject

Show properties

idstringrequired

startTimestring<date-time>required

endTimestring<date-time> | nullrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Basic auth usernameBasic auth password

Remember on this deviceInclude my values in samples

Parameters

idpath*Content block IDuserIdpath*User ID

Request

curl -X GET 'https://fuxam.app/api/v4/content-blocks/string/progress/string' \
  -H 'Authorization: Basic YOUR_CREDENTIALS' \
  -H 'Accept: application/json'

const response = await fetch("https://fuxam.app/api/v4/content-blocks/string/progress/string", {
  method: "GET",
  headers: {
    "Authorization": "Basic YOUR_CREDENTIALS",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://fuxam.app/api/v4/content-blocks/string/progress/string",
    headers={
        "Authorization": "Basic YOUR_CREDENTIALS",
        "Accept": "application/json"
    },
)

Response

{
  "data": {
    "blockId": "string",
    "userId": "string",
    "status": "NOT_STARTED",
    "lockState": "UNLOCKED",
    "startedAt": "2019-08-24T14:15:22Z",
    "completedAt": "2019-08-24T14:15:22Z",
    "userData": {},
    "conditions": [
      {
        "conditionId": "string",
        "requiredBlockId": "string",
        "requiredBlockName": "string",
        "met": true
      }
    ]
  },
  "meta": {
    "requestId": "req_1234567890_abc",
    "timestamp": "2026-06-02T07:00:00.000Z",
    "version": "v4",
    "watermark": "2019-08-24T14:15:22Z"
  }
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "existingUserId": "string",
  "activeSession": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z"
  },
  "conflictingLog": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z",
    "endTime": "2019-08-24T14:15:22Z"
  }
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "existingUserId": "string",
  "activeSession": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z"
  },
  "conflictingLog": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z",
    "endTime": "2019-08-24T14:15:22Z"
  }
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "existingUserId": "string",
  "activeSession": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z"
  },
  "conflictingLog": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z",
    "endTime": "2019-08-24T14:15:22Z"
  }
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "existingUserId": "string",
  "activeSession": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z"
  },
  "conflictingLog": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z",
    "endTime": "2019-08-24T14:15:22Z"
  }
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "existingUserId": "string",
  "activeSession": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z"
  },
  "conflictingLog": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z",
    "endTime": "2019-08-24T14:15:22Z"
  }
}