---
title: "List tax filings"
method: GET
path: "/tax_filings"
---

# List tax filings

`GET /tax_filings`

## Request

- Base URL: `https://sandbox.checkhq.com`
- URL: `https://sandbox.checkhq.com/tax_filings`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/checkhq/apis/check-api/docs/tax_filings/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a list of tax filings. Please note that in its current iteration, only `rejected` filings are returned.

## Query parameters

- `company` string
- `year` integer
- `period` string
- `limit` integer
- `id` string[]

## Response `200`

200

- object
  - `next` unknown
  - `previous` unknown
  - `results` object[]
    - `id` string
    - `status` string
    - `amount` string
    - `type` string
    - `parent_type` string: The parent type of the payment. One of `payroll`, `payroll_item`, `contractor_payment`, `collection`, `refund`, or `correction`. Payments that fund a correction report `correction` as the parent type.
    - `parent_id` string: The id of the parent of the payment (see `parent_type`). An id can be a `pay_...`, `itm_...`, `cpa_...`, `pyt_...`, or `cor_...` id. When `parent_type` is `correction`, this is the correction's id.
    - `payment_attempts` object[]
      - `id` string
      - `created_at` string
      - `expected_completion_date` string
      - `status` string
      - `failure_code` unknown
      - `payment_method` string
      - `payment_instrument` string
      - `wire_details` unknown
    - `can_retry` boolean
    - `can_refund` boolean
    - `direction` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `5a54f5eb888b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/checkhq/apis/check-api/changes/tax_filings/get.md)

---

[API](https://skmtc.dev/checkhq/apis/check-api.md) - [All operations](https://skmtc.dev/checkhq/apis/check-api/llms.txt) - [OpenAPI document](https://skmtc.dev/checkhq/apis/check-api/revisions/5a54f5eb888b?raw)