Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

Tax Constituent Activity (POST)

Returns activity for a taxpayer, including optional views for filing, earnings, payments, and assessments for a given tax year.

Resource

1/connect/public-sector/tax-revenue/constituents/${constituentId}/activity

Available version

68.0

HTTP methods

POST

Request body for POST

JSON Filing example

1{
2  "taxYear": 2025,
3  "views": {
4"filing": ["lineItem","participants"],
5"document": [],
6}
7}

JSON Payments example

1{
2  "taxYear": 2025,
3  "views": ["payments"]
4}

JSON Refunds example

1{
2  "taxYear": 2025,
3  "views": ["refunds"]
4}

JSON Assessments example

1{
2  "taxYear": 2025,
3  "views": ["assessments"]
4}

JSON All views example

1{
2  "taxYear": 2025
3}

Properties

Name	Type	Description	Required or Optional	Available Version
`dataMappingObjects`	Map<String, ConnectApi.DataMappingObjectInput>	Per-DMO additional fields beyond defaults. Key = DMO name (TaxFiling, TaxFilingParticipant, TaxFilingLineItem, TaxPayment, TaxRefund, TaxFilingAssessment, TaxFilingLineItemAssessment, TaxDocument, TaxDocumentItem). Value = object with fields array. Maximum 30 additional fields total.		68.0
`taxYear`	Integer	Required. The tax year to return activity for.	Required	68.0
`views`	Map<String, ConnectApi.TaxActivityViewInput>	Scopes which sections are returned and, per section, which child sub-sections to expand. Map of view name to a per-view expansion object whose subViews lists the child sub-sections to expand. Allowed view keys are filings, documents, payments, refunds, and assessments. Sub-view names per view are filings = [participants, lineItems] and assessments = [lineItems]; documents, payments, and refunds have no sub-views. An empty object or omitted subViews for a view (e.g. "documents": {}) selects that view with its default sub-views. An empty or omitted map returns all views with their default sub-views. Unknown view keys are rejected.		68.0

Response body for POST

Tax Constituent Activity

Request parameters for POST

Parameter Name	Type	Description	Required or Optional	Available Version
`constituentId`	String	The ID of the constituent (taxpayer). Supplied as a variable in the resource URL.	Required	68.0
`taxConstituentActivityInput`	Object	The query input. The request body maps to `TaxConstituentActivityInput` .	Required	68.0

Public Sector Developer Guide

Tax Constituent Activity (POST)