---
updatedAt: 2026-09-17T00:06:26.000Z
agentTools:
  projectIndex: https://developer.drivewealth.com/apis/llms.txt
---

# Retrieve contribution limits

Retrieves standard contribution limits and age-based catch-up parameters for Traditional IRAs, Roth IRAs, and Trump Accounts for a given tax year.

Traditional and Roth IRAs share one combined limit: a client holding both has a single allowance across the two, not the full limit in each.

# OpenAPI definition

```json
{
  "openapi": "3.0.2",
  "info": {
    "title": "Money Movement APIs",
    "version": "2026-11-07",
    "contact": {
      "email": "producteng@drivewealth.tech"
    }
  },
  "servers": [
    {
      "url": "https://bo-api.drivewealth.io/back-office",
      "description": "Sandbox (No Real World Financial/Trading Impact)"
    },
    {
      "url": "https://bo-api.drivewealth.net/back-office",
      "description": "Production"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-readme": {
    "explorer-enabled": false,
    "headers": [
      {
        "key": "dw-client-app-key",
        "value": "{{yourAppKey}}"
      }
    ]
  },
  "tags": [
    {
      "name": "Contribution Limits"
    }
  ],
  "paths": {
    "/contribution-limits": {
      "get": {
        "tags": [
          "Contribution Limits"
        ],
        "operationId": "getContributionLimits",
        "summary": "Retrieve contribution limits",
        "description": "Retrieves standard contribution limits and age-based catch-up parameters for Traditional IRAs, Roth IRAs, and Trump Accounts for a given tax year.\n\nTraditional and Roth IRAs share one combined limit: a client holding both has a single allowance across the two, not the full limit in each.",
        "parameters": [
          {
            "in": "query",
            "name": "taxYear",
            "required": false,
            "schema": {
              "type": "integer",
              "example": 2026
            },
            "description": "The tax year to retrieve limits for. Defaults to the current calendar year when omitted."
          }
        ],
        "responses": {
          "200": {
            "description": "Retrieving contribution limits was successful.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContributionLimitsResponse"
                },
                "examples": {
                  "Contribution limits for 2026": {
                    "value": {
                      "taxYear": 2026,
                      "contributionLimits": {
                        "ira": {
                          "accountTypes": [
                            "TRADITIONAL_IRA",
                            "ROTH_IRA"
                          ],
                          "standardLimit": 7500,
                          "catchUpAge": 50,
                          "catchUpAllowance": 1000,
                          "maximumAllowedLimit": 8500,
                          "note": "Traditional and Roth IRA contributions share this combined limit; it is not a separate limit per account type."
                        },
                        "trumpAccount": {
                          "accountTypes": [
                            "TRUMP_ACCOUNT"
                          ],
                          "standardLimit": 5000,
                          "maximumAge": 17,
                          "maximumAllowedLimit": 5000,
                          "contributionTypes": [
                            {
                              "contributionType": "SEC_128_EMPLOYER",
                              "description": "Employer contribution; tax-free to the employee.",
                              "subLimit": {
                                "cumulativeAmount": 2000,
                                "limitApplied": 2500,
                                "remainingAllowance": 500,
                                "isLimitReached": false
                              },
                              "countsTowardLimit": true
                            },
                            {
                              "contributionType": "OTHER_SOURCE",
                              "description": "Individual contributions (parent, grandparent, or other person), made with after-tax dollars.",
                              "subLimit": null,
                              "countsTowardLimit": true
                            },
                            {
                              "contributionType": "QUALIFIED_ROLLOVER",
                              "description": "Trustee-to-trustee transfer of the entire balance from another Trump Account.",
                              "subLimit": null,
                              "countsTowardLimit": false,
                              "note": "Not expected to occur under current product scope; included here for completeness."
                            },
                            {
                              "contributionType": "PILOT_PROGRAM",
                              "description": "U.S. Treasury $1,000 grant for eligible children born 2025–2028.",
                              "subLimit": null,
                              "countsTowardLimit": false
                            },
                            {
                              "contributionType": "QUALIFIED_GENERAL",
                              "description": "Grants from government entities, tribes, or 501(c)(3) organizations.",
                              "subLimit": null,
                              "countsTowardLimit": false
                            }
                          ]
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseModel"
                },
                "examples": {
                  "Malformed taxYear": {
                    "value": {
                      "errorCode": "E025",
                      "message": "Invalid or badly formatted request. Refer to the API documentation for details. Details: Invalid value: taxYear. Must be a four-digit year."
                    }
                  },
                  "Limits not published for tax year": {
                    "value": {
                      "errorCode": "E025",
                      "message": "Invalid or badly formatted request. Refer to the API documentation for details. Details: Invalid value: taxYear. Limits are not published for the requested tax year."
                    }
                  },
                  "taxYear out of supported range": {
                    "value": {
                      "errorCode": "E025",
                      "message": "Invalid or badly formatted request. Refer to the API documentation for details. Details: Invalid value: taxYear. Must be between 2025 and the current tax year."
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ErrorCode": {
        "type": "string",
        "description": "The error code that is returned when an error occurs.",
        "example": "E032"
      },
      "ErrorCodeMessage": {
        "type": "string",
        "description": "The error message that is returned when an error occurs."
      },
      "ErrorDetails": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string",
            "description": "JSON field name from the request body that caused an error"
          },
          "type": {
            "type": "string",
            "enum": [
              "STRING",
              "ARRAY",
              "INT",
              "DECIMAL",
              "BOOL",
              "TEXT",
              "UUID",
              "DATE",
              "MAP",
              "OBJECT",
              "ENUM"
            ],
            "description": "Expected data type of the field",
            "x-enumDescriptions": {
              "STRING": "The value is a string.",
              "ARRAY": "The value is an array.",
              "INT": "The value is an integer.",
              "DECIMAL": "The value is a decimal number.",
              "BOOL": "The value is a boolean.",
              "TEXT": "The value is free-form text.",
              "UUID": "The value is a UUID.",
              "DATE": "The value is a date.",
              "MAP": "The value is a key-value map.",
              "OBJECT": "The value is an object.",
              "ENUM": "The value is one of a fixed set of enumerated values."
            }
          },
          "allowedValues": {
            "type": "string",
            "description": "Example values which are allowed in the field"
          },
          "detail": {
            "type": "string",
            "description": "Additional validation or error details for the field"
          }
        }
      },
      "ErrorResponseModel": {
        "type": "object",
        "description": "The error response model that is returned when an error occurs.",
        "required": [
          "errorCode",
          "message"
        ],
        "properties": {
          "errorCode": {
            "$ref": "#/components/schemas/ErrorCode"
          },
          "message": {
            "$ref": "#/components/schemas/ErrorCodeMessage"
          },
          "errorDetails": {
            "$ref": "#/components/schemas/ErrorDetails"
          }
        }
      },
      "ContributionLimitsResponse": {
        "type": "object",
        "description": "Standard contribution limits and catch-up parameters for a given tax year.",
        "properties": {
          "taxYear": {
            "type": "integer",
            "example": 2026,
            "description": "The tax year the returned limits apply to."
          },
          "contributionLimits": {
            "$ref": "#/components/schemas/ContributionLimits"
          }
        }
      },
      "ContributionLimits": {
        "type": "object",
        "description": "Container for per-account-family contribution limits.",
        "properties": {
          "ira": {
            "$ref": "#/components/schemas/IraContributionLimit"
          },
          "trumpAccount": {
            "$ref": "#/components/schemas/TrumpAccountContributionLimit"
          }
        }
      },
      "IraContributionLimit": {
        "type": "object",
        "description": "Combined limit governing Traditional and Roth IRAs. The limit is shared across both account types, not applied separately to each.",
        "properties": {
          "accountTypes": {
            "type": "array",
            "description": "Account types governed by this combined limit.",
            "items": {
              "type": "string",
              "example": "TRADITIONAL_IRA"
            }
          },
          "standardLimit": {
            "type": "number",
            "example": 7500,
            "description": "Base annual limit, shared across all listed account types."
          },
          "catchUpAge": {
            "type": "integer",
            "example": 50,
            "description": "Age at which the catch-up allowance becomes available."
          },
          "catchUpAllowance": {
            "type": "number",
            "example": 1000,
            "description": "Additional amount permitted once catchUpAge is met."
          },
          "maximumAllowedLimit": {
            "type": "number",
            "example": 8500,
            "description": "The maximum allowed limit: standardLimit plus catchUpAllowance."
          },
          "note": {
            "type": "string",
            "description": "Clarification of the combined-limit behavior.",
            "example": "Traditional and Roth IRA contributions share this combined limit; it is not a separate limit per account type."
          }
        }
      },
      "TrumpAccountContributionLimit": {
        "type": "object",
        "description": "Limit governing Trump Accounts. No catch-up allowance applies.",
        "properties": {
          "accountTypes": {
            "type": "array",
            "description": "Account types governed by this limit.",
            "items": {
              "type": "string",
              "example": "TRUMP_ACCOUNT"
            }
          },
          "standardLimit": {
            "type": "number",
            "example": 5000,
            "description": "Base annual limit."
          },
          "maximumAge": {
            "type": "integer",
            "example": 17,
            "description": "Oldest age at which contributions are permitted."
          },
          "maximumAllowedLimit": {
            "type": "number",
            "example": 5000,
            "description": "Ceiling for the account. No catch-up applies."
          },
          "contributionTypes": {
            "type": "array",
            "description": "Per-contribution-type rules. Two of the five types consume the annual limit; the remaining three are permitted regardless of remaining headroom.",
            "items": {
              "$ref": "#/components/schemas/TrumpAccountContributionType"
            }
          }
        }
      },
      "TrumpAccountContributionType": {
        "type": "object",
        "description": "Rules for a single Trump Account contribution funding source.",
        "properties": {
          "contributionType": {
            "type": "string",
            "description": "The funding source this rule applies to.",
            "enum": [
              "SEC_128_EMPLOYER",
              "OTHER_SOURCE",
              "QUALIFIED_ROLLOVER",
              "PILOT_PROGRAM",
              "QUALIFIED_GENERAL"
            ],
            "example": "SEC_128_EMPLOYER",
            "x-enumDescriptions": {
              "SEC_128_EMPLOYER": "An employer contribution (Trump account).",
              "OTHER_SOURCE": "An individual contribution (Trump account).",
              "QUALIFIED_ROLLOVER": "A trustee-to-trustee transfer of the entire balance from another Trump account.",
              "PILOT_PROGRAM": "A contribution under the U.S. Treasury pilot program (Trump account).",
              "QUALIFIED_GENERAL": "A grant from a government, tribe, or 501(c)(3) organization (Trump account)."
            }
          },
          "description": {
            "type": "string",
            "description": "Plain-language description of the funding source.",
            "example": "Employer contribution; tax-free to the employee."
          },
          "subLimit": {
            "type": "object",
            "nullable": true,
            "description": "Cap specific to this contribution type, expressed in account currency, along with usage against that cap. Null when no type-specific cap applies.",
            "example": {
              "cumulativeAmount": 2000,
              "limitApplied": 2500,
              "remainingAllowance": 500,
              "isLimitReached": false
            },
            "properties": {
              "cumulativeAmount": {
                "type": "number",
                "format": "double",
                "example": 2000,
                "description": "Total amount contributed toward this sub-limit so far for the tax year."
              },
              "limitApplied": {
                "type": "number",
                "format": "double",
                "example": 2500,
                "description": "The sub-limit cap applied to this contribution type."
              },
              "remainingAllowance": {
                "type": "number",
                "format": "double",
                "example": 500,
                "description": "Remaining allowance before the sub-limit is reached."
              },
              "isLimitReached": {
                "type": "boolean",
                "example": false,
                "description": "Whether the sub-limit has been reached."
              }
            }
          },
          "countsTowardLimit": {
            "type": "boolean",
            "example": true,
            "description": "Whether contributions of this type consume the standardLimit."
          },
          "note": {
            "type": "string",
            "description": "Optional additional context. Present only where extra clarification is needed.",
            "example": "Not expected to occur under current product scope; included here for completeness."
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  }
}
```

# Sibling pages

* [Retrieve annual contribution tally](https://developer.drivewealth.com/apis/reference/getannualcontributiontally.md)