---
title: "Get all tax payments for a company"
method: GET
path: "/v1/companies/{company_uuid}/tax_payments"
tags: ["Tax Payments"]
---

# Get all tax payments for a company

`GET /v1/companies/{company_uuid}/tax_payments`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/companies/{company_uuid}/tax_payments`
- Auth: HTTP bearer

Fetches all tax payments Gusto has made (or scheduled) to tax agencies on behalf of a company.

scope: `tax_payments:read`

## Path parameters

- `company_uuid` string, required

## Query parameters

- `jurisdiction` string[]
- `payroll_uuids` string[]
- `due_date_from` string, date
- `due_date_to` string, date
- `payment_sent_on_from` string, date
- `payment_sent_on_to` string, date
- `period_start_from` string, date
- `period_start_to` string, date
- `period_end_from` string, date
- `period_end_to` string, date
- `amount_min` number, float
- `amount_max` number, float
- `sort_by` string
- `page` integer
- `per` integer

## Headers

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

## Response `200`

Success

- TaxPayment[]
  - `uuid` string, required: Unique identifier of the tax payment
  - `company_uuid` string, required: Unique identifier of the company to which the tax payment belongs
  - `agency_name` string, nullable, required: The name of the tax agency this payment is submitted to. Null for legacy tax payments whose agent has no reference-data agency.
  - `jurisdiction` string, nullable, required: The tax jurisdiction this payment is for. A two-letter state code, or US for federal. Null for legacy tax payments whose agent has no reference-data agency.
  - `period_start` string, date, nullable, required: The start date of the period this payment covers. Null for legacy tax payments where the period start was never recorded.
  - `period_end` string, date, required: The end date of the period this payment covers
  - `due_date` string, date, nullable, required: The date this payment is due. Null for legacy tax payments where the due date was never recorded.
  - `payment_sent_on` string, date, nullable: The date Gusto submitted this payment to the tax agency. It is null until submitted, and also if the payment is returned or cancelled after being sent. It is not guaranteed to stay set once populated.
  - `amount` string, float, required: Total amount owed for this tax payment. Can be negative for corrections, refunds, or credits.
  - `amount_paid` string, float, required: Amount paid toward this tax payment so far, sourced from the payment's running balance. "0.00" until paid; equal to `amount` once fully paid.
  - `line_items` TaxPaymentLineItem[]: The payroll tax liabilities that make up this payment. Empty array when the payment has no associated payroll taxes. Only included in the response of GET /v1/companies/{company_uuid}/tax_payments/{uuid}. It is omitted from the list endpoint response.
    - `payroll_uuid` string, required: Unique identifier of the payroll this liability came from
    - `unique_tax_id` string, required: Unique identifier of the tax type this liability is for
    - `amount` string, float, required: The amount of this liability included in the tax payment

## Other responses

- `404`: Not Found The requested resource does not exist. Make sure the provided UUID is valid.
- `422`: Unprocessable Entity This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details.

## Changes

- **2026-11-03** `f98575fa2a5e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gusto/apis/gusto-api/changes/v1/companies/:company_uuid/tax_payments/get.md)

---

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