Tax Constituent Activity (POST)

Returns activity for the logged-in taxpayer for a single tax year. The response includes only the views and sub-views the request selects: filings, documents, payments, refunds, and assessments.

Resource

1/connect/public-sector/tax-revenue/tax-account/activities

Available Version

68.0

HTTP Methods

POST

Request Body for POST

JSON Example

1{
2  "taxYear": 2025,
3  "views": {
4    "filings": { "subViews": ["participants", "lineItems", "address"] },
5    "payments": {},
6    "documents": { "subViews": ["items"] }
7  }
8}

Properties

Name	Type	Description	Required or Optional	Available Version
`taxYear`	String	The tax year to return activity for. For example, 2025.	Required	68.0
`includeAllViews`	Boolean	When true, every view is returned and views is ignored. Default is false.	Optional	68.0
`views`	Map<String, TaxActivityViewInput>	Views to return, each with the sub-views to expand. Allowed keys are filings, payments, refunds, assessments, and documents. Sub-views are filings: participants, lineItems, address; assessments: lineItems; documents: items. Payments and refunds have no sub-views. When includeAllViews is false, only keys present in this map are returned. An empty or omitted map returns no views. Unknown view keys are rejected.	Optional	68.0

Response Body for POST

Tax Constituent Activity

Request Parameters for POST

Parameter Name	Type	Description	Required or Optional	Available Version
`taxRevenueActivityInputRepresentation`	Object	Required. Tax year and the views to return. An empty or omitted views map returns no views. The request body maps to `TaxRevenueActivityInput` .	Required	68.0