Tax Revenue Profile (POST)

Returns the logged-in taxpayer’s display name and available filing years. This POST has no request body.

Resource 

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

Available Version 

68.0

HTTP Methods 

POST

Response Status Codes 

The taxpayer is the logged-in user. Request-level failures use these status codes. Error messages are generic.

Status CodeError CodeDescription
200 The profile was returned.
400RESOURCE_NOT_FOUNDThe requested taxpayer record was not found.
403 Access denied. The caller lacks the permissions that gate this resource.
404RESOURCE_NOT_FOUNDYour tax records are not available yet. Please contact your tax agency for assistance.
500UNKNOWN_EXCEPTIONA required data service is temporarily unavailable, tax information isn’t set up yet, the taxpayer record can’t be uniquely identified, or Identity Resolution is missing or misconfigured. The message tells the caller to try again or contact the tax agency.

Request Body for POST 

This POST has no request body. The logged-in user determines the tax account.

Response Body for POST 

Tax Revenue Profile