Activity Records

Activity record management operations

Get activity records

get

http://localhost:3000/api/v1https://api.example.com/v1

/activity/record

Retrieve a list of activity records with optional filtering and pagination

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

activityIdstring · uuidOptional

activityRecordIdstring · uuidOptional

memberIdstring · uuidOptional

statusstringOptional

approvalStatusstringOptional

startDatestring · dateOptional

endDatestring · dateOptional

pageSizestringOptional

pageNumberstringOptional

sortBystringOptional

sortOrderstring · enumOptionalPossible values:

Responses

200

Successfully retrieved activity records

application/json

401

Unauthorized access

application/json

500

Internal server error

application/json

get

/activity/record

HTTPcURLJavaScriptPython

GET /api/v1/activity/record HTTP/1.1
Host: localhost:3000
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "message": "text",
  "data": [
    {
      "activityRecordId": "123e4567-e89b-12d3-a456-426614174000",
      "activityId": "123e4567-e89b-12d3-a456-426614174000",
      "memberId": "123e4567-e89b-12d3-a456-426614174000",
      "status": "active",
      "approvalStatus": "pending",
      "firstApprovalBy": "text",
      "firstApprovalDate": "text",
      "rejectionBy": "text",
      "rejectionDate": "text",
      "rejectionReason": "text",
      "secondApprovalBy": "text",
      "secondApprovalDate": "text",
      "timeIn": "2025-12-16T02:58:42.557Z",
      "timeOut": "2025-12-16T02:58:42.557Z",
      "timeInLocation": "text",
      "timeOutLocation": "text",
      "timeInImage": "text",
      "timeOutImage": "text",
      "liveLocation": [
        "text"
      ],
      "timeInDuration": "text",
      "calculatedDuration": "text",
      "amendedDuration": "text",
      "gracePeriodEndDate": "text",
      "durationObjectionReason": "text",
      "isAssigned": true,
      "pointsGiven": "text",
      "hoursGiven": "text",
      "memberScoreBeforeCalculation": "text",
      "memberScoreAfterCalculation": "text",
      "participantRoleId": "123e4567-e89b-12d3-a456-426614174000",
      "specialAchievement": true,
      "guardianId": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2025-12-16T02:58:42.557Z",
      "updatedAt": "2025-12-16T02:58:42.557Z",
      "updatedBy": "text",
      "createdBy": "text"
    }
  ],
  "pagination": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalItems": 1,
    "totalPages": 1
  }
}

Get activity record approving count

get

http://localhost:3000/api/v1https://api.example.com/v1

/activity/record/approving-count

Get count of activity records that are being approved

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

activityIdstring · uuidOptional

memberIdstring · uuidOptional

statusstringOptional

approvalStatusstringOptional

Responses

200

Successfully retrieved count

application/json

500

Internal server error

application/json

get

/activity/record/approving-count

HTTPcURLJavaScriptPython

GET /api/v1/activity/record/approving-count HTTP/1.1
Host: localhost:3000
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "message": "text",
  "count": 1
}

Get activity record status count

get

http://localhost:3000/api/v1https://api.example.com/v1

/activity/record/status-count

Get count of activity records by status

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDatestring · dateOptional

endDatestring · dateOptional

Responses

200

Successfully retrieved status count

application/json

500

Internal server error

application/json

get

/activity/record/status-count

HTTPcURLJavaScriptPython

GET /api/v1/activity/record/status-count HTTP/1.1
Host: localhost:3000
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "message": "text",
  "count": {}
}

Get activity record approval status count

get

http://localhost:3000/api/v1https://api.example.com/v1

/activity/record/approval/status-count

Get count of activity records by approval status

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDatestring · dateOptional

endDatestring · dateOptional

Responses

200

Successfully retrieved approval status count

application/json

500

Internal server error

application/json

get

/activity/record/approval/status-count

HTTPcURLJavaScriptPython

GET /api/v1/activity/record/approval/status-count HTTP/1.1
Host: localhost:3000
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "message": "text",
  "count": {}
}

Create activity record

post

http://localhost:3000/api/v1https://api.example.com/v1

/activity/record/create

Create activity records for members

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

activityIdstring · uuidRequired

Responses

201

Activity records created successfully

application/json

400

Validation error

application/json

401

Unauthorized access

application/json

500

Internal server error

application/json

post

/activity/record/create

HTTPcURLJavaScriptPython

POST /api/v1/activity/record/create HTTP/1.1
Host: localhost:3000
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 218

{
  "activityId": "123e4567-e89b-12d3-a456-426614174000",
  "members": [
    {
      "memberId": "123e4567-e89b-12d3-a456-426614174000",
      "isAssigned": true,
      "participantRoleId": "123e4567-e89b-12d3-a456-426614174000",
      "approvalStatus": "text"
    }
  ]
}

{
  "success": true,
  "message": "text",
  "data": {
    "created": [
      {
        "activityRecordId": "123e4567-e89b-12d3-a456-426614174000",
        "activityId": "123e4567-e89b-12d3-a456-426614174000",
        "memberId": "123e4567-e89b-12d3-a456-426614174000",
        "status": "active",
        "approvalStatus": "pending",
        "firstApprovalBy": "text",
        "firstApprovalDate": "text",
        "rejectionBy": "text",
        "rejectionDate": "text",
        "rejectionReason": "text",
        "secondApprovalBy": "text",
        "secondApprovalDate": "text",
        "timeIn": "2025-12-16T02:58:42.557Z",
        "timeOut": "2025-12-16T02:58:42.557Z",
        "timeInLocation": "text",
        "timeOutLocation": "text",
        "timeInImage": "text",
        "timeOutImage": "text",
        "liveLocation": [
          "text"
        ],
        "timeInDuration": "text",
        "calculatedDuration": "text",
        "amendedDuration": "text",
        "gracePeriodEndDate": "text",
        "durationObjectionReason": "text",
        "isAssigned": true,
        "pointsGiven": "text",
        "hoursGiven": "text",
        "memberScoreBeforeCalculation": "text",
        "memberScoreAfterCalculation": "text",
        "participantRoleId": "123e4567-e89b-12d3-a456-426614174000",
        "specialAchievement": true,
        "guardianId": "123e4567-e89b-12d3-a456-426614174000",
        "createdAt": "2025-12-16T02:58:42.557Z",
        "updatedAt": "2025-12-16T02:58:42.557Z",
        "updatedBy": "text",
        "createdBy": "text"
      }
    ],
    "conflicts": [
      {}
    ]
  }
}

Update activity record

put

http://localhost:3000/api/v1https://api.example.com/v1

/activity/record/update/{activityRecordId}

Update an existing activity record

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

activityRecordIdstring · uuidRequired

Body

application/json

approvalStatusstring · enumOptionalPossible values:

firstApprovalBystringOptional

firstApprovalDatestringOptional

rejectionBystringOptional

rejectionDatestringOptional

rejectionReasonstringOptional

timeInstring · date-timeOptional

timeOutstring · date-timeOptional

timeInLocationstringOptional

timeOutLocationstringOptional

timeInImagestringOptional

timeOutImagestringOptional

liveLocationstring[]Optional

timeInDurationstringOptional

calculatedDurationstringOptional

amendedDurationstringOptional

gracePeriodEndDatestringOptional

durationObjectionReasonstringOptional

isAssignedbooleanOptional

pointsGivenstringOptional

hoursGivenstringOptional

memberScoreBeforeCalculationstringOptional

memberScoreAfterCalculationstringOptional

participantRoleIdstring · uuidOptional

specialAchievementbooleanOptional

guardianIdstring · uuidOptional

updatedBystringOptional

Responses

200

Activity record updated successfully

application/json

400

Validation error

application/json

401

Unauthorized access

application/json

500

Internal server error

application/json

put

/activity/record/update/{activityRecordId}

HTTPcURLJavaScriptPython

PUT /api/v1/activity/record/update/{activityRecordId} HTTP/1.1
Host: localhost:3000
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 766

{
  "approvalStatus": "pending",
  "firstApprovalBy": "text",
  "firstApprovalDate": "text",
  "rejectionBy": "text",
  "rejectionDate": "text",
  "rejectionReason": "text",
  "timeIn": "2025-12-16T02:58:42.557Z",
  "timeOut": "2025-12-16T02:58:42.557Z",
  "timeInLocation": "text",
  "timeOutLocation": "text",
  "timeInImage": "text",
  "timeOutImage": "text",
  "liveLocation": [
    "text"
  ],
  "timeInDuration": "text",
  "calculatedDuration": "text",
  "amendedDuration": "text",
  "gracePeriodEndDate": "text",
  "durationObjectionReason": "text",
  "isAssigned": true,
  "pointsGiven": "text",
  "hoursGiven": "text",
  "memberScoreBeforeCalculation": "text",
  "memberScoreAfterCalculation": "text",
  "participantRoleId": "123e4567-e89b-12d3-a456-426614174000",
  "specialAchievement": true,
  "guardianId": "123e4567-e89b-12d3-a456-426614174000",
  "updatedBy": "text"
}

{
  "success": true,
  "message": "text",
  "data": {},
  "pagination": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalItems": 1,
    "totalPages": 1
  }
}

Raise duration objection

post

http://localhost:3000/api/v1https://api.example.com/v1

/activity/raise-duration-objection

Raise an objection regarding the approved duration

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

activityRecordIdstring · uuidRequired

objectionstring · min: 1Required

Responses

200

Duration objection raised successfully

application/json

400

Validation error

application/json

401

Unauthorized access

application/json

403

Forbidden

404

Activity record not found

500

Internal server error

application/json

post

/activity/raise-duration-objection

HTTPcURLJavaScriptPython

POST /api/v1/activity/raise-duration-objection HTTP/1.1
Host: localhost:3000
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 78

{
  "activityRecordId": "123e4567-e89b-12d3-a456-426614174000",
  "objection": "text"
}

{
  "success": true,
  "message": "text",
  "data": {},
  "pagination": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalItems": 1,
    "totalPages": 1
  }
}

Finalize duration after objection

post

http://localhost:3000/api/v1https://api.example.com/v1

/activity/finalize-duration/{activityRecordId}

Make final verdict on duration after objection

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

activityRecordIdstring · uuidRequired

Body

application/json

hoursGivennumberRequired

Responses

200

Final verdict made successfully

application/json

400

Validation error

application/json

401

Unauthorized access

application/json

500

Internal server error

application/json

post

/activity/finalize-duration/{activityRecordId}

HTTPcURLJavaScriptPython

POST /api/v1/activity/finalize-duration/{activityRecordId} HTTP/1.1
Host: localhost:3000
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "hoursGiven": 1
}

{
  "success": true,
  "message": "text",
  "data": {},
  "pagination": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalItems": 1,
    "totalPages": 1
  }
}