> ## Documentation Index
> Fetch the complete documentation index at: https://cobalt-55-abhishek.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Human Task

> Get a public human task (form) by ID.

Fetch a human task (a form generated by a workflow's human-in-the-loop step) for end-user display. This is a **public, no-auth** endpoint — share the URL directly with the person who needs to fill out the form. Internal fields (`delayed_job_id`, `instance_id`, `node_id`, `org_id`, `associated_form_id`) are stripped from the response.

<Note>
  No API key or session token is required. The task ID is the secret — treat the link as sensitive.
</Note>

## Path Parameters

<ParamField path="id" type="string" required>The human task ID (issued when the workflow reaches the human-task step).</ParamField>

## Response

<Tabs>
  <Tab title="200 OK">
    <ResponseField name="_id" type="string">Task ID.</ResponseField>
    <ResponseField name="name" type="string">Task name.</ResponseField>
    <ResponseField name="description" type="string">Task description.</ResponseField>
    <ResponseField name="form_structure" type="object">JSON-schema describing the form fields.</ResponseField>
    <ResponseField name="ui_structure" type="object">UI hints for rendering the form.</ResponseField>
    <ResponseField name="data" type="object">Any pre-filled data.</ResponseField>
    <ResponseField name="status" type="string">`WAITING`, `SUBMITTED`, or `TIMEOUT`.</ResponseField>
    <ResponseField name="expire_in" type="string">ISO 8601 expiry timestamp.</ResponseField>
    <ResponseField name="receiver_emails" type="array">Emails the task was sent to.</ResponseField>
  </Tab>

  <Tab title="404 Not Found">
    <ResponseField name="status_code" type="integer">HTTP status code.</ResponseField>
    <ResponseField name="http_error_type" type="string">Error category.</ResponseField>
    <ResponseField name="error_code" type="string">Internal error code.</ResponseField>
    <ResponseField name="message" type="string">Human-readable error description.</ResponseField>
  </Tab>
</Tabs>

<ResponseExample>
  ```json 200 theme={null}
  {
    "_id": "6a31a2f0d396207fd2510000",
    "name": "Approve Discount",
    "description": "Review and approve the requested discount.",
    "form_structure": {
      "type": "object",
      "required": ["approved"],
      "properties": {
        "approved": { "type": "boolean", "title": "Approve?" },
        "notes": { "type": "string", "title": "Notes" }
      }
    },
    "ui_structure": { "approved": { "ui:widget": "radio" } },
    "data": {},
    "status": "WAITING",
    "expire_in": "2026-06-20T00:00:00.000Z",
    "receiver_emails": ["approver@example.com"],
    "createdAt": "2026-06-16T13:20:00.000Z",
    "updatedAt": "2026-06-16T13:20:00.000Z"
  }
  ```

  ```json 404 theme={null}
  {
    "status_code": 404,
    "http_error_type": "NOT_FOUND",
    "error_code": "SERVER_ERROR",
    "message": "Specified Form Not Found"
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://app.refold.ai/api/v2/public/human-tasks/{id}"
  ```
</RequestExample>