GUgusto
Tax Payments

Get a tax payment for a company

Changed on

Fetches a single tax payment by UUID, including the payroll tax liabilities that make up the payment.

scope: tax_payments:read

get/v1/companies/{company_uuid}/tax_payments/{uuid}

Request

  • Base URL
    https://api.gusto-demo.com
  • Auth
    HTTP bearer

Path parameters

company_uuidstring required

The UUID of the company

uuidstring required

The UUID of the tax payment

Headers

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

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Response

Success

uuidstring required

Unique identifier of the tax payment

company_uuidstring required

Unique identifier of the company to which the tax payment belongs

agency_namestring 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.

jurisdictionstring 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_startstring 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_endstring date required

The end date of the period this payment covers

due_datestring date nullable required

The date this payment is due. Null for legacy tax payments where the due date was never recorded.

payment_sent_onstring 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.

amountstring float required

Total amount owed for this tax payment. Can be negative for corrections, refunds, or credits.

amount_paidstring 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.

Changes