CHcheckhq

List contractor tax documents

Changed on

Returns contractor tax documents. Each document includes created_at, an ISO 8601 UTC timestamp of when the document was recorded. When multiple documents share the same filed_on date, compare created_at to tell which was recorded later.

get/documents/contractor_tax_documents

Request

Query parameters

contractorstring

Return documents for this contractor ID.

companystring

Return documents for this company ID. Results will include tax documents for all contractors who perform work for this company.

yearinteger

Return documents for this year (must be greater than or equal to 2019)

document_typestring[]

Return documents with this document type. Repeat the parameter to match any of multiple values (for example, ?document_type=fed_1099_nec&document_type=fed_w9). Filtering on fed_1099_nec also matches legacy rows stored as 1099_nec.

limitinteger

Number of tax documents returned per page. The maximum value is 25.

idstring[]

Filter the list to the specified IDs. For more details, check out the Bulk Get Requests guide.

Response

200

nextstring nullable

URL of the next page of results; null on the last page.

previousstring nullable

URL of the previous page of results; null on the first page.

Example response

{
  "next": "https://api.checkhq.com/documents/contractor_tax_documents?cursor=cD0lNUIlMjIyMDI0LTA3LTI2KzE2JTNBMTAlM0EwMy44OTY5ODclMkIwMCUzQTAwJTIyJTJDKyUyMjQwNTk4MSUyMiU1RA%3D%3D",
  "results": [
    {
      "id": "doc_7Ns2KdVq9LwXe4TbRj1M",
      "contractor": "ctr_Pz8wQnR4mVt2LkYb6HsJ",
      "category": "contractor_tax_document",
      "document_type": "fed_1099_nec",
      "label": "Form 1099-NEC",
      "description": "Form 1099-NEC is filed annually to report non-employee compensation.",
      "jurisdiction": "FED",
      "year": 2024,
      "filed_on": "2025-01-28",
      "created_at": "2025-01-28T15:06:47.381902Z"
    }
  ]
}

Changes

  • 5a54f5eb888bRevision changes
    • info

      added the new optional query request parameter document_type

    • info

      added the new optional query request parameter id

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status