DRdrivewealth
Withholding Defaults

Retrieve withholding defaults

Retrieves the federal and state-specific default withholding percentages applied to retirement distributions for a given tax year.

These are the rates DriveWealth applies when a distribution request carries no withholding election of its own. This endpoint is a read-only reference lookup — calling it does not create, set, or change a withholding election for any client, and the values returned are not scoped to an individual. To submit an election, set it on the distribution request itself.

get/withholding-defaults

Request

  • Base URL
    https://bo-api.drivewealth.io/back-office
  • URL
    https://bo-api.drivewealth.io/back-office/withholding-defaults
  • Auth
    HTTP bearer

Query parameters

taxYearinteger
Example:2026

The tax year to retrieve defaults for. Defaults to the current calendar year when omitted.

statestring
Example:VT

Two-letter U.S. state code. Narrows the response to a single state. Omit to return defaults for all states.

Response

Retrieving withholding defaults was successful.

taxYearinteger

The tax year the returned defaults apply to.

federalDefaultPercentagenumber

The default federal withholding rate, expressed as a decimal fraction.

Example response

{
  "taxYear": 2026,
  "federalDefaultPercentage": 0.1,
  "stateSpecificItems": [
    {
      "state": "VT",
      "stateDefaultPercentage": 0.3,
      "isWithholdingMandatory": true
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.