CHcheckhq

List contractor tax statements

Changed on

The Contractor Tax Statements API is currently in limited preview, and is not yet generally available.

Returns a paginated list of contractor tax statements. contractor or company is required; a request with neither returns a 400 validation error. Requires an API key with the contractor:read, contractor:write, or contractor:admin scope.

get/contractor_tax_statements

Request

Query parameters

contractorstring

Return statements for this contractor. Required unless company is set.

companystring

Return statements for this company. Required unless contractor is set.

yearinteger

Return statements for this tax year.

publication_status'draft' | 'published' | 'pending_correction'

draft returns unpublished statements and published returns published ones. pending_correction is accepted but returns no results.

type'original' | 'amendment'

original returns every statement. amendment is accepted but returns no results.

limitinteger

Number of statements returned per page. The maximum value is 500.

cursorstring

Pagination cursor from a next or previous response URL.

Response

200

nextstring nullable

URL of the next page, or null on the last page.

previousstring nullable

URL of the previous page, or null on the first page.

Example response

{
  "results": [
    {
      "id": "cts_789",
      "contractor": "ctr_123",
      "company": "com_123",
      "year": 2026,
      "publication_status": "draft",
      "delivery_method": "manual"
    }
  ]
}

Changes