SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester
tasks

Fetch one assignment with its submissions, reviews and full event history.

Fetch one assignment with its submissions, reviews and full event history.

GEThttps://app.softsolz.uk/api/v1/services/tasks/assignments/{id}

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

idstringrequired

Headers

Authorizationstringrequired

Bearer token: `Bearer sk_live_...` (or `sk_test_...` for sandbox). A login token will not work here.

Response

Response Body

assignmentobjectOne person copy of the task.
taskobjectThe task this assignment came from.
submissionsarray of objectsEvery attempt, newest first.
reviewsarray of objectsEvery decision made on those attempts.
eventsarray of objectsThe full history: who had it, when it moved, what the deadline was, and why each change happened.

Request

curl --request GET \
--url https://app.softsolz.uk/api/v1/services/tasks/assignments/{id} \
--header 'Authorization: Bearer sk_live_your_key'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
"data": {
"assignment": {
"id": 900,
"task_id": 42,
"assignee_user_id": 31,
"assigned_by": 8,
"group_id": 3,
"delegated_by": null,
"delegation_reason": null,
"status": "submitted",
"due_at": "2026-09-03T17:00:00.000Z",
"original_due_at": "2026-09-01T17:00:00.000Z",
"checklist_state": [
{
"id": "floor-1",
"checked_at": "2026-09-01T10:00:00.000Z",
"checked_by": 31
}
],
"custom_fields": {},
"score": 92,
"attempt_count": 2,
"started_at": null,
"submitted_at": null,
"completed_at": null,
"reopened_at": null,
"updated_at": "2026-09-02T08:00:00.000Z"
},
"task": {
"id": 42,
"category_id": 7,
"title": "Quarterly safety inspection",
"instructions": "Walk every floor and photograph each extinguisher.",
"priority": "high",
"status": "published",
"due_at": "2026-09-01T17:00:00.000Z",
"schedule_mode": "one_time",
"starts_at": null,
"submission_mode": "file_and_text",
"required_files": 1,
"allowed_submission_count": 3,
"allow_late_submission": true,
"grading_scheme": null,
"max_score": 100,
"weight": 2,
"rubric": [
{
"id": "accuracy",
"label": "Accuracy",
"max_score": 40,
"weight": 1
}
],
"checklist": [
{
"id": "floor-1",
"label": "Floor 1 complete",
"required": true
}
],
"attachments": [
{
"filename": "report.pdf",
"mime": "application/pdf",
"size_bytes": 184320,
"download_url": "https://s3.eu-west-2.amazonaws.com/...",
"content_url": "/api/services/tasks/files/content?key=tasks%2F..."
}
],
"custom_fields": {
"property": "Riverside House",
"inspection_type": "annual"
},
"source": "api",
"template_id": null,
"assignment_count": 12,
"created_at": "2026-08-01T09:00:00.000Z",
"updated_at": "2026-08-02T11:15:00.000Z"
},
"submissions": [
{
"id": 5001,
"assignment_id": 900,
"attempt_no": 2,
"note": "All floors done.",
"files": [
{
"filename": "report.pdf",
"mime": "application/pdf",
"size_bytes": 184320,
"download_url": "https://s3.eu-west-2.amazonaws.com/...",
"content_url": "/api/services/tasks/files/content?key=tasks%2F..."
}
],
"custom_fields": {},
"is_late": false,
"submitted_at": "2026-09-02T08:00:00.000Z"
}
],
"reviews": [
{
"id": 7001,
"submission_id": 5001,
"reviewer_id": 8,
"stage": 1,
"decision": "approved",
"feedback": "Clear and complete.",
"score": 92,
"rubric_scores": [
{
"criterion_id": "accuracy",
"score": 38
}
],
"created_at": "2026-09-02T09:00:00.000Z"
}
],
"events": [
{
"id": 12001,
"assignment_id": 900,
"event_type": "reassigned",
"from_user_id": 31,
"to_user_id": 44,
"from_value": "assigned",
"to_value": "in_progress",
"changed_by": 8,
"reason": "Sarah is on leave.",
"created_at": "2026-09-01T12:00:00.000Z"
}
]
}
}