---
title: "List Submissions"
method: GET
path: "/api/livechat/widgets/{widget_id}/submissions"
tags: ["livechat", "livechat"]
---

# List Submissions

`GET /api/livechat/widgets/{widget_id}/submissions`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/livechat/widgets/{widget_id}/submissions`
- Auth: none declared

List form submissions for a specific widget.

Supports filtering by status and pagination.
Returns submissions with widget name and processor info.

## Path parameters

- `widget_id` integer, required

## Query parameters

- `status` 'new' | 'processed': Possible statuses for a form submission.
- `limit` integer: Max items to return
- `offset` integer: Offset for pagination
- `sort_by` string: Field to sort by
- `sort_order` string: Sort order: asc or desc

## Response `200`

Successful Response

- SubmissionsListResponse: Response for listing submissions.
  - `submissions` SubmissionResponse[], required
    - `id` integer, required
    - `widget_id` integer, required
    - `widget_name` string, nullable
    - `thread_id` integer, nullable
    - `entity_id` integer, nullable
    - `person_id` integer, nullable
    - `form_data` object, required
    - `field_schema` FieldSchema[], required
      - `key` string, required
      - `label` string, required
      - `type` string
    - `status` 'new' | 'processed', required: Possible statuses for a form submission.
    - `processed_by` integer, nullable
    - `processed_by_name` string, nullable
    - `processed_at` string, date-time, nullable
    - `notes` string, nullable
    - `visitor_id` string, nullable
    - `page_url` string, nullable
    - `ip_address` string, nullable
    - `user_agent` string, nullable
    - `location` object, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `total` integer, required
  - `has_more` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)