---
title: "Get paperwork submissions"
method: POST
path: "/paperwork/submissions"
---

# Get paperwork submissions

`POST /paperwork/submissions`

## Request body

- IGetPaperworkSubmissionsRequest
  - `companyID` string, required — Unique identifier for the company.
  - `jurisdiction_filter` union — Filter for jurisdictions to include or exclude.
    - object
      - `type` 'include' | 'exclude' — Type of jurisdiction filter (include or exclude).
      - `jurisdictions` string[]
    - object
      - `type` 'all' — Filter for all jurisdictions.
  - `worker_filter` union — Filter for workers to include or exclude.
    - object
      - `type` 'include' | 'exclude' — Type of employee filter (include or exclude).
      - `employeeIDs` string[]
    - object
      - `type` 'include' | 'exclude' — Type of contractor filter (include or exclude).
      - `contractorIDs` string[]
    - object
      - `type` 'all' — Filter for all workers.

## Response `200`

Successful response

- IGetPaperworkSubmissionsResponse
  - `success` boolean — Indicates if the operation was successful.
  - `data` IPaperworkSubmission[]
    - `templateID` string, required — Unique identifier for the paperwork template.
    - `submissionID` string, required — Unique identifier for the paperwork submission.
    - `submission_date` string, required — Date and time when the submission was created.
    - `worker_type` 'Employee' | 'Contractor' | 'All', required — Type of worker (Employee, Contractor, or All).
    - `companyID` string, required — Unique identifier for the company.
    - `employeeID` string, nullable — Unique identifier for the employee. Nullable if the worker type is contractor.
    - `contractorID` string, nullable — Unique identifier for the contractor. Nullable if the worker type is employee.
    - `fields` object, required — Additional fields for the paperwork submission.
    - `paperwork_type` 'W4' | 'CustomPaperwork' | 'I9' | 'W9', required — Type of paperwork.
    - `url` string, required — URL for the submission.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/zeal/apis/zeal-api.md) · [All operations](https://skmtc.net/zeal/apis/zeal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zeal/zeal-api/revisions/01346dceb27d/schema)