List Case Tasks

curl --request GET \
  --url https://connect.penbox.io/v1/cases/{id}/tasks \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "9b1c4b2e-1f3a-4f8c-9c2d-47aaaf50be97",
      "created_at": "2026-08-31T09:54:39.963Z",
      "case": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" },
      "type": "fill_form",
      "title": null,
      "description": null,
      "status": "in_progress",
      "due_at": "2026-09-07T00:00:00.000Z",
      "completed_at": null,
      "step_key": "ask_documents",
      "assignee": {
        "kind": "contact",
        "id": "d322ce86-fb0a-4fc9-b45a-28758840108c",
        "email": "client@example.com",
        "given_name": "Judd",
        "family_name": "Haley"
      }
    },
    {
      "id": "2c7e2ddd-ece1-4c38-9c2d-47aaaf50be97",
      "created_at": "2026-08-31T10:12:04.100Z",
      "case": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" },
      "type": "manual",
      "title": "Call the client back",
      "description": "The client asked for a callback before Friday.",
      "status": "open",
      "due_at": "2026-09-04T00:00:00.000Z",
      "completed_at": null,
      "step_key": null,
      "assignee": {
        "kind": "member",
        "id": "5f7e2c17-e9be-47c9-8049-0b35d8eb0ada",
        "email": "amina@firm.example",
        "given_name": "Amina",
        "family_name": "Berger"
      }
    }
  ]
}

GET

cases

{id}

tasks

curl --request GET \
  --url https://connect.penbox.io/v1/cases/{id}/tasks \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "9b1c4b2e-1f3a-4f8c-9c2d-47aaaf50be97",
      "created_at": "2026-08-31T09:54:39.963Z",
      "case": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" },
      "type": "fill_form",
      "title": null,
      "description": null,
      "status": "in_progress",
      "due_at": "2026-09-07T00:00:00.000Z",
      "completed_at": null,
      "step_key": "ask_documents",
      "assignee": {
        "kind": "contact",
        "id": "d322ce86-fb0a-4fc9-b45a-28758840108c",
        "email": "client@example.com",
        "given_name": "Judd",
        "family_name": "Haley"
      }
    },
    {
      "id": "2c7e2ddd-ece1-4c38-9c2d-47aaaf50be97",
      "created_at": "2026-08-31T10:12:04.100Z",
      "case": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" },
      "type": "manual",
      "title": "Call the client back",
      "description": "The client asked for a callback before Friday.",
      "status": "open",
      "due_at": "2026-09-04T00:00:00.000Z",
      "completed_at": null,
      "step_key": null,
      "assignee": {
        "kind": "member",
        "id": "5f7e2c17-e9be-47c9-8049-0b35d8eb0ada",
        "email": "amina@firm.example",
        "given_name": "Amina",
        "family_name": "Berger"
      }
    }
  ]
}

List the tasks of a case, oldest due date first. A task is a follow-up: something one person has to do before the case can move on. Every task belongs to exactly one side, told by assignee.kind:

`assignee.kind`	Whose job it is	Closed by
`member`	someone on the team	the team, or your integration
`contact`	the client	submitting the form Penbox sent them
`null` (unassigned)	nobody yet	anyone on the team

This list includes the tasks Penbox creates by itself when a form step moves — “Complete the form” for the client, “Review the answers” for the team — so you can mirror the real state of the case in your own product.

Tasks are scoped to the workspaces your token covers. A case in another workspace returns an empty list rather than an error.

The response is not paginated and returns at most 100 tasks, oldest due date first. A case is not expected to carry more.

curl --request GET \
  --url https://connect.penbox.io/v1/cases/{id}/tasks \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "9b1c4b2e-1f3a-4f8c-9c2d-47aaaf50be97",
      "created_at": "2026-08-31T09:54:39.963Z",
      "case": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" },
      "type": "fill_form",
      "title": null,
      "description": null,
      "status": "in_progress",
      "due_at": "2026-09-07T00:00:00.000Z",
      "completed_at": null,
      "step_key": "ask_documents",
      "assignee": {
        "kind": "contact",
        "id": "d322ce86-fb0a-4fc9-b45a-28758840108c",
        "email": "client@example.com",
        "given_name": "Judd",
        "family_name": "Haley"
      }
    },
    {
      "id": "2c7e2ddd-ece1-4c38-9c2d-47aaaf50be97",
      "created_at": "2026-08-31T10:12:04.100Z",
      "case": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" },
      "type": "manual",
      "title": "Call the client back",
      "description": "The client asked for a callback before Friday.",
      "status": "open",
      "due_at": "2026-09-04T00:00:00.000Z",
      "completed_at": null,
      "step_key": null,
      "assignee": {
        "kind": "member",
        "id": "5f7e2c17-e9be-47c9-8049-0b35d8eb0ada",
        "email": "amina@firm.example",
        "given_name": "Amina",
        "family_name": "Berger"
      }
    }
  ]
}

Authorizations

Authorization

string

header

required

API token (starts with pnbx_). Create at https://app.penbox.io/workspace/settings/api. Include as: Authorization: Bearer {token}

Path Parameters

string<uuid>

required

Case UUID

Response

200 - application/json

Successful response

data

object[]

Show child attributes

API Reference

Workspaces

Cases

Tasks

Case Templates

Forms

Form Templates

Attachments

Document Intelligence

Signatures

Previous API version

Authorizations

Path Parameters

Response