Rippling: GET Employee 401k Deduction — response body
GET Employee 401k Deduction: response body. Complete fields and constraints for contract 2026-10-28.
API reference · Contract 2026-10-28
SDK schema: GET Employee 401k Deduction — response body
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | The 401k Deduction Model. |
caps | JSON | Optional | |
caps (anyOf 1) | object | Alternative | The 401k Limit Object. This object represents the caps set on both employee and employer contribution amounts for traditional and ROTH 401ks. |
caps (anyOf 1).employee_401k_limit | JSON | Optional | |
caps (anyOf 1).employee_401k_limit (anyOf 1) | JSON | Alternative | |
caps (anyOf 1).employee_401k_limit (anyOf 1) (anyOf 1) | number | Alternative | For all 401k accounts (Roth, and Traditional) Format: float Minimum: 0 |
caps (anyOf 1).employee_401k_limit (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
caps (anyOf 1).employee_401k_limit (anyOf 2) | null | Alternative | |
caps (anyOf 1).roth | JSON | Optional | |
caps (anyOf 1).roth (anyOf 1) | object | Alternative | |
caps (anyOf 1).roth (anyOf 1).ee | JSON | Optional | |
caps (anyOf 1).roth (anyOf 1).ee (anyOf 1) | string | Alternative | Employee Roth 401k Limit |
caps (anyOf 1).roth (anyOf 1).ee (anyOf 2) | null | Alternative | |
caps (anyOf 1).roth (anyOf 1).er | JSON | Optional | |
caps (anyOf 1).roth (anyOf 1).er (anyOf 1) | string | Alternative | Employer Roth 401k limit |
caps (anyOf 1).roth (anyOf 1).er (anyOf 2) | null | Alternative | |
caps (anyOf 1).roth (anyOf 2) | null | Alternative | |
caps (anyOf 1).total_401k_limit | JSON | Optional | |
caps (anyOf 1).total_401k_limit (anyOf 1) | number | Alternative | Total contribution limit from the employee and the employer. Format: float Minimum: 0 |
caps (anyOf 1).total_401k_limit (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
caps (anyOf 1).traditional | object | Optional | |
caps (anyOf 1).traditional.ee | JSON | Optional | |
caps (anyOf 1).traditional.ee (anyOf 1) | string | Alternative | Employee traditional 401k limit. |
caps (anyOf 1).traditional.ee (anyOf 2) | null | Alternative | |
caps (anyOf 1).traditional.employee_401k_limit | JSON | Optional | |
caps (anyOf 1).traditional.employee_401k_limit (anyOf 1) | string | Alternative | The traditional employee 401k limit. |
caps (anyOf 1).traditional.employee_401k_limit (anyOf 2) | null | Alternative | |
caps (anyOf 1).traditional.er | JSON | Optional | |
caps (anyOf 1).traditional.er (anyOf 1) | string | Alternative | Employer traditional 401k limit. |
caps (anyOf 1).traditional.er (anyOf 2) | null | Alternative | |
caps (anyOf 2) | null | Alternative | |
employer | string | Optional | Either a flat dollar or % employer traditional contribution amount. This should be used in conjunction with employer_is_percent. Note, this field should not be set if the employer is using a tiered match. This value will be overridden by the calculated match using the tiered match. If the field is omitted, it will not be updated. |
employer_roth_is_percent | boolean | Optional | Whether the employer ROTH contribution amount provided is a percentage of the gross wages or a flat dollar contribution amount. Note, this field should not be set if the employer is using a tiered match. |
employer_traditional_is_percent | boolean | Optional | Whether the employer traditional contribution amount provided is a percentage of the gross wages or a flat dollar contribution amount. Note, this field should not be set if the employer is using a tiered match. |
loan | string | Optional | Either a flat dollar or % loan contribution amount. This should be used in conjunction with loan_is_percent. |
loan_is_percent | boolean | Optional | Whether the loan contribution amount provided is a percentage of the gross wages or a flat dollar contribution amount. |
roth | string | Optional | Either a flat dollar or % contribution amount. This should be used in conjunction with roth_is_percent. |
roth_employer | string | Optional | Either a flat dollar or % employer ROTH contribution amount. This should be used in conjunction with employer_roth_is_percent. Note, this field should not be set if the employer is using a tiered match. This value will be overridden by the calculated match using the tiered match. |
roth_is_percent | boolean | Optional | Whether the ROTH contribution amount provided is a percentage of the gross wages or a flat dollar contribution amount. |
traditional | string | Optional | Either a flat dollar or % contribution amount. This should be used in conjunction with traditional_is_percent. |
traditional_is_percent | boolean | Optional | Whether the traditional contribution amount provided is a percentage of the gross wages or a flat dollar contribution amount. |