GUgusto
Tax Payments

Get all tax payments for a company

Changed on

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

scope: tax_payments:read

get/v1/companies/{company_uuid}/tax_payments

Request

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

Path parameters

company_uuidstring required

The UUID of the company

Query parameters

jurisdictionstring[]

Filter by tax jurisdiction. Accepts one or more two-letter state codes, or US for federal, as a comma-separated list (e.g. IL,CA). Codes are case-insensitive.

payroll_uuidsstring[]

Filter to tax payments associated with one or more payrolls, given as a comma-separated list of payroll UUIDs.

due_date_fromstring date

Lower-bound (inclusive) date filter on due_date.

due_date_tostring date

Upper-bound (inclusive) date filter on due_date.

payment_sent_on_fromstring date

Lower-bound (inclusive) date filter on payment_sent_on.

payment_sent_on_tostring date

Upper-bound (inclusive) date filter on payment_sent_on.

period_start_fromstring date

Lower-bound (inclusive) date filter on period_start.

period_start_tostring date

Upper-bound (inclusive) date filter on period_start.

period_end_fromstring date

Lower-bound (inclusive) date filter on period_end.

period_end_tostring date

Upper-bound (inclusive) date filter on period_end.

amount_minnumber float

Lower-bound (inclusive) filter on amount.

amount_maxnumber float

Upper-bound (inclusive) filter on amount.

sort_bystring
Example:amount:asc

Sort by one or more fields. Options: amount, due_date, payment_sent_on, period_end, period_start. Append :asc or :desc to specify direction (e.g., amount:asc). Defaults to ascending.

pageinteger

The page that is requested. When unspecified, will load all objects unless endpoint forces pagination.

perinteger

Number of objects per page. For majority of endpoints will default to 25

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