Get all tax payments for a company

get

https://api.gusto-demo.com/v1/companies/{company_uuid}/tax_payments

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

scope: tax_payments:read

Path Params

company_uuid

string

required

The UUID of the company

Query Params

jurisdiction

array of strings

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.

jurisdiction

due_date_from

date

Lower-bound (inclusive) date filter on due_date.

due_date_to

date

Upper-bound (inclusive) date filter on due_date.

payment_sent_on_from

date

Lower-bound (inclusive) date filter on payment_sent_on.

payment_sent_on_to

date

Upper-bound (inclusive) date filter on payment_sent_on.

period_start_from

date

Lower-bound (inclusive) date filter on period_start.

period_start_to

date

Upper-bound (inclusive) date filter on period_start.

period_end_from

date

Lower-bound (inclusive) date filter on period_end.

period_end_to

date

Upper-bound (inclusive) date filter on period_end.

amount_min

float

Lower-bound (inclusive) filter on amount.

amount_max

float

Upper-bound (inclusive) filter on amount.

sort_by

string

^(amount|due_date|payment_sent_on|period_end|period_start)(:(asc|desc))?(,(amount|due_date|payment_sent_on|period_end|period_start)(:(asc|desc))?)*$

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.

page

integer

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

per

integer

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

Headers

X-Gusto-API-Version

string

enum

Defaults to 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.

Allowed:

Responses

200Success

404Not Found The requested resource does not exist. Make sure the provided UUID is valid.

422Unprocessable 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 guide for more details.