---
title: "Get all contractor forms"
method: GET
path: "/v1/contractors/{contractor_uuid}/forms"
tags: ["Contractor Forms"]
---

# Get all contractor forms

`GET /v1/contractors/{contractor_uuid}/forms`

Get a list of all contractor's forms

scope: `contractor_forms:read`

## Path parameters

- `contractor_uuid` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Response `200`

Example response

- Form1099[]
  - `uuid` string, required — The UUID of the form
  - `name` string — The type identifier of the form
  - `title` string — The title of the form
  - `description` string — The description of the form
  - `draft` boolean — If the form is in a draft state. E.g. End of year tax forms may be provided in a draft state prior to being finalized.
  - `year` integer, nullable — The year of this form. For some forms, e.g. tax forms, this is the year which the form represents. A 1099 for January - December 2022 would be delivered in January 2023 and have a year value of 2022. This value is nullable and will not be present on all forms.
  - `quarter` integer, nullable — The quarter of this form. This value is currently always null since it is not present on any contractor forms.
  - `requires_signing` boolean — A boolean flag that indicates whether the form needs signing or not. Note that this value will change after the form is signed.
  - `document_content_type` string, nullable — The content type of the associated document. Most forms are PDFs with a content type of `application/pdf`. Some tax file packages will be zip files (containing PDFs) with a content type of `application/zip`. This attribute will be `null` when the document has not been prepared.
  - `contractor_uuid` string — The contractor UUID

## Other responses

- `404` — Not Found The requested resource does not exist. Make sure the provided UUID is valid.

---

[API](https://skmtc.dev/gusto/apis/gusto-api.md) · [All operations](https://skmtc.dev/gusto/apis/gusto-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gusto/gusto-api/revisions/826dfa57fb3b/schema)