# Update PremRate Updates a specific PremRate. Endpoint: PUT /premium-rates/{premRateKey} Version: v1 Security: apiKeyAuth, bearerAuth ## Header parameters: - `vbasoftware-database` (string, required) Target database ## Path parameters: - `premRateKey` (integer, required) PremRate Key ## Request fields (application/json): - `premRate_Key` (integer, required) Unique identifier for the PremRate Note: This field is marked as NOT NULL in the database and therefore required by the API. - `add_On_Grouping_ID` (string,null) Used to identify Add On rates by Group - `additional_Invoice_Address` (string,null) Address the additional invoice is sent to - `additional_Invoice_Frequency` (string,null) Frequency of the additional invoice - `additional_Invoice_Level` (string,null) Allows split billing at this level - `address_Type` (string,null) Level of the Address used to determine if the rate applies - `adjustment_Reason` (integer,null) Adjustment Reason of the PremRate - `adult` (boolean, required) Flag used to determine if the rate applies to Adults Note: This field is marked as NOT NULL in the database and therefore required by the API. - `age_From` (integer,null) Beginning Age range of the PremRate - `age_Thru` (integer,null) Ending Age range of the PremRate - `age_Type` (string,null) Detemines what date is used to calculate Age - `age_Type_Month` (string,null) Detemines what Month is used if the Month Type is selected - `assign_To_New_Division` (boolean, required) Flag to determine if the rate applies to new Divisions Note: This field is marked as NOT NULL in the database and therefore required by the API. - `assign_To_New_Group` (boolean, required) Flag to determine if the rate applies to new Groups Note: This field is marked as NOT NULL in the database and therefore required by the API. - `assign_To_New_Member` (boolean, required) Flag to determine if the rate applies to new Members Note: This field is marked as NOT NULL in the database and therefore required by the API. - `auto_Adjust` (boolean, required) Flag that determines if the rate is automatically adjusted Note: This field is marked as NOT NULL in the database and therefore required by the API. - `auto_Adjust_Reason` (integer,null) Reason applied to automatic adjustments - `avoid_Retro` (boolean, required) This flag indicates prevention of the retro logic from creating backout adjustments for this rate Note: This field is marked as NOT NULL in the database and therefore required by the API. - `benefit_Code` (string,null) Benefit Code of the PremRate - `billing_Cycle_ID` (string,null) This is the Billing Cycle the invoice was gerenated for. - `child` (boolean, required) Flag used to determine if the rate applies to Children Note: This field is marked as NOT NULL in the database and therefore required by the API. - `city` (string,null) City of the Address used to determine if the rate applies - `class_Code` (string,null) Class Code for the PremRate - `country_ID` (string,null) Country ID of the Address used to determine if the rate applies - `county_Code` (string,null) Country Code of the Address used to determine if the rate applies - `description` (string,null) Description of the PremRate - `division_ID` (string,null) Unique identifier for the Division - `effective_Date` (string,null) Effective Date of the PremRate - `effective_Date_Type` (string,null) Determines the logic that modifies the Effective Date of the PremRate to a date based on the enrollment of the member. Note: The database will apply a default value of NORMAL for this field if a value is not provided. - `employee_Employer_Contribution` (string,null) Determines if the contribution is Employee or Employer - `employer_Contribution` (number,null) Amount of the contribution - `employer_Contribution_Pct` (boolean, required) Determines if the contribution is a percentage Note: This field is marked as NOT NULL in the database and therefore required by the API. - `employer_Rate` (number,null) Decimal value that defines the base employer rate - `employer_Rate_Max` (number,null) Maximum the employer rate will be regardless of the calculation - `employer_Rate_Minimum` (number,null) Minimum the employer rate will be regardless of the calculation - `employer_Rate_Type` (string,null) Type of Employer Rate - `employer_Rate_Variable1` (number,null) First variable used in calculating the employer rate based on the type - `employer_Rate_Variable2` (number,null) Second variable used in calculating the employer rate based on the type - `employer_Rate_Variable3` (number,null) Third variable used in calculating the employer rate based on the type - `employer_Round_Precision` (integer,null) Precision that the employerrate is rounded to - `employer_Round_Type` (string,null) Type that determine how the employer rate is rounded - `enrolled_Count_From` (integer,null) Beginning range based on number of enrollments - `enrolled_Count_Thru` (integer,null) Ending range based on number of enrollments - `enrolled_Count_Type` (string,null) Type of enrollments used to calculate the number of enrollments - `enrolled_Duration_From` (integer,null) Beginning range based on length of enrollment - `enrolled_Duration_Min` (integer,null) Minimum length of enrollment - `enrolled_Duration_Option` (string,null) Determines if the date is based on the Member or the Plan enrollment - `enrolled_Duration_Thru` (integer,null) Ending range based on length of enrollment - `enrolled_Duration_Type` (string,null) Type of date used to determine the enrollment range - `entry_Date` (string) Date record was first added to the system - `entry_User` (string,null) User that first added the record to the system - `group_Division_Offering` (boolean, required) Used to determine which records are updated when applying changes to a template Note: This field is marked as NOT NULL in the database and therefore required by the API. - `group_ID` (string,null) Unique identifier for the Group - `member_Seq` (string,null) Unique sequence for a Member - `network_ID` (string,null) Unique identifier for the Network - `network_Type` (string,null) Type of Network - `new_Hire_Age` (boolean, required) Flag that determines the Age based on the date of hire Note: This field is marked as NOT NULL in the database and therefore required by the API. - `override_Enrolled_Dates` (boolean, required) This flag indicates the rate should be paid if enrolled in for even a single day during the month. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `parent_PremRate_Key` (integer,null) PremRate_Key of the template rate this rate was created from - `payment_Method` (string,null) The primary key of the payment method - `plan_ID` (string,null) Unique identifier for the Plan - `plan_Type` (string,null) Type of Plan - `premRate_Basis` (string,null) Basis of the PremRate - `premRate_Category` (string,null) Category of the PremRate - `premRate_ID` (string,null) Unique identifier for the PremRate - `premRate_Type` (string,null) Type of the PremRate - `premium_Proration` (boolean, required) Flag that determines if the rate is prorated Note: This field is marked as NOT NULL in the database and therefore required by the API. - `rate` (number,null) Decimal value that defines the base rate - `rate_Max` (number,null) Maximum the rate will be regardless of the calculation - `rate_Minimum` (number,null) Minimum the rate will be regardless of the calculation - `rate_Pace` (string,null) How often the rate applies - `rate_Pace_Type` (string,null) The day the rate applies when the pace is weekly - `rate_Round_Precision` (integer,null) Precision that the rate is rounded to - `rate_Round_Type` (string,null) Type that determine how the rate is rounded - `rate_Type` (string,null) Type of Rate - `rate_Variable1` (number,null) First variable used in calculating the rate based on the type - `rate_Variable2` (number,null) Second variable used in calculating the rate based on the type - `rate_Variable3` (number,null) Third variable used in calculating the rate based on the type - `region_Code` (string,null) Region Code of the Address used to determine if the rate applies - `relationship` (string,null) Relationship for the PremRate - `sex` (string,null) Flag used to determine what Sex the rate applies to - `smoker` (string,null) Flag to determine if the rate applies to Smokers - `state` (string,null) State of the Address used to determine if the rate applies - `subscriber_ID` (string,null) Unique identifier for the Subscriber - `term_Date` (string,null) Term Date of the PremRate - `term_Date_type` (string,null) Determines the logic that modifies the Term Date of the PremRate to a date based on the enrollment of the member. Note: The database will apply a default value of NORMAL for this field if a value is not provided. - `tier` (string,null) Tier of the PremRate - `update_Date` (string) Date the record was last updated in the system - `update_User` (string,null) User that last updated the record in the system - `zip_Code_From` (string,null) Beginning Zip Code of the Address used to determine if the rate applies - `zip_Code_Thru` (string,null) Ending Zip Code of the Address used to determine if the rate applies ## Response 200 fields (text/plain): - `data` (object) - `data.premRate_Key` (integer, required) Unique identifier for the PremRate Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.add_On_Grouping_ID` (string,null) Used to identify Add On rates by Group - `data.additional_Invoice_Address` (string,null) Address the additional invoice is sent to - `data.additional_Invoice_Frequency` (string,null) Frequency of the additional invoice - `data.additional_Invoice_Level` (string,null) Allows split billing at this level - `data.address_Type` (string,null) Level of the Address used to determine if the rate applies - `data.adjustment_Reason` (integer,null) Adjustment Reason of the PremRate - `data.adult` (boolean, required) Flag used to determine if the rate applies to Adults Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.age_From` (integer,null) Beginning Age range of the PremRate - `data.age_Thru` (integer,null) Ending Age range of the PremRate - `data.age_Type` (string,null) Detemines what date is used to calculate Age - `data.age_Type_Month` (string,null) Detemines what Month is used if the Month Type is selected - `data.assign_To_New_Division` (boolean, required) Flag to determine if the rate applies to new Divisions Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.assign_To_New_Group` (boolean, required) Flag to determine if the rate applies to new Groups Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.assign_To_New_Member` (boolean, required) Flag to determine if the rate applies to new Members Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.auto_Adjust` (boolean, required) Flag that determines if the rate is automatically adjusted Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.auto_Adjust_Reason` (integer,null) Reason applied to automatic adjustments - `data.avoid_Retro` (boolean, required) This flag indicates prevention of the retro logic from creating backout adjustments for this rate Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.benefit_Code` (string,null) Benefit Code of the PremRate - `data.billing_Cycle_ID` (string,null) This is the Billing Cycle the invoice was gerenated for. - `data.child` (boolean, required) Flag used to determine if the rate applies to Children Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.city` (string,null) City of the Address used to determine if the rate applies - `data.class_Code` (string,null) Class Code for the PremRate - `data.country_ID` (string,null) Country ID of the Address used to determine if the rate applies - `data.county_Code` (string,null) Country Code of the Address used to determine if the rate applies - `data.description` (string,null) Description of the PremRate - `data.division_ID` (string,null) Unique identifier for the Division - `data.effective_Date` (string,null) Effective Date of the PremRate - `data.effective_Date_Type` (string,null) Determines the logic that modifies the Effective Date of the PremRate to a date based on the enrollment of the member. Note: The database will apply a default value of NORMAL for this field if a value is not provided. - `data.employee_Employer_Contribution` (string,null) Determines if the contribution is Employee or Employer - `data.employer_Contribution` (number,null) Amount of the contribution - `data.employer_Contribution_Pct` (boolean, required) Determines if the contribution is a percentage Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.employer_Rate` (number,null) Decimal value that defines the base employer rate - `data.employer_Rate_Max` (number,null) Maximum the employer rate will be regardless of the calculation - `data.employer_Rate_Minimum` (number,null) Minimum the employer rate will be regardless of the calculation - `data.employer_Rate_Type` (string,null) Type of Employer Rate - `data.employer_Rate_Variable1` (number,null) First variable used in calculating the employer rate based on the type - `data.employer_Rate_Variable2` (number,null) Second variable used in calculating the employer rate based on the type - `data.employer_Rate_Variable3` (number,null) Third variable used in calculating the employer rate based on the type - `data.employer_Round_Precision` (integer,null) Precision that the employerrate is rounded to - `data.employer_Round_Type` (string,null) Type that determine how the employer rate is rounded - `data.enrolled_Count_From` (integer,null) Beginning range based on number of enrollments - `data.enrolled_Count_Thru` (integer,null) Ending range based on number of enrollments - `data.enrolled_Count_Type` (string,null) Type of enrollments used to calculate the number of enrollments - `data.enrolled_Duration_From` (integer,null) Beginning range based on length of enrollment - `data.enrolled_Duration_Min` (integer,null) Minimum length of enrollment - `data.enrolled_Duration_Option` (string,null) Determines if the date is based on the Member or the Plan enrollment - `data.enrolled_Duration_Thru` (integer,null) Ending range based on length of enrollment - `data.enrolled_Duration_Type` (string,null) Type of date used to determine the enrollment range - `data.entry_Date` (string) Date record was first added to the system - `data.entry_User` (string,null) User that first added the record to the system - `data.group_Division_Offering` (boolean, required) Used to determine which records are updated when applying changes to a template Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.group_ID` (string,null) Unique identifier for the Group - `data.member_Seq` (string,null) Unique sequence for a Member - `data.network_ID` (string,null) Unique identifier for the Network - `data.network_Type` (string,null) Type of Network - `data.new_Hire_Age` (boolean, required) Flag that determines the Age based on the date of hire Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.override_Enrolled_Dates` (boolean, required) This flag indicates the rate should be paid if enrolled in for even a single day during the month. Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.parent_PremRate_Key` (integer,null) PremRate_Key of the template rate this rate was created from - `data.payment_Method` (string,null) The primary key of the payment method - `data.plan_ID` (string,null) Unique identifier for the Plan - `data.plan_Type` (string,null) Type of Plan - `data.premRate_Basis` (string,null) Basis of the PremRate - `data.premRate_Category` (string,null) Category of the PremRate - `data.premRate_ID` (string,null) Unique identifier for the PremRate - `data.premRate_Type` (string,null) Type of the PremRate - `data.premium_Proration` (boolean, required) Flag that determines if the rate is prorated Note: This field is marked as NOT NULL in the database and therefore required by the API. - `data.rate` (number,null) Decimal value that defines the base rate - `data.rate_Max` (number,null) Maximum the rate will be regardless of the calculation - `data.rate_Minimum` (number,null) Minimum the rate will be regardless of the calculation - `data.rate_Pace` (string,null) How often the rate applies - `data.rate_Pace_Type` (string,null) The day the rate applies when the pace is weekly - `data.rate_Round_Precision` (integer,null) Precision that the rate is rounded to - `data.rate_Round_Type` (string,null) Type that determine how the rate is rounded - `data.rate_Type` (string,null) Type of Rate - `data.rate_Variable1` (number,null) First variable used in calculating the rate based on the type - `data.rate_Variable2` (number,null) Second variable used in calculating the rate based on the type - `data.rate_Variable3` (number,null) Third variable used in calculating the rate based on the type - `data.region_Code` (string,null) Region Code of the Address used to determine if the rate applies - `data.relationship` (string,null) Relationship for the PremRate - `data.sex` (string,null) Flag used to determine what Sex the rate applies to - `data.smoker` (string,null) Flag to determine if the rate applies to Smokers - `data.state` (string,null) State of the Address used to determine if the rate applies - `data.subscriber_ID` (string,null) Unique identifier for the Subscriber - `data.term_Date` (string,null) Term Date of the PremRate - `data.term_Date_type` (string,null) Determines the logic that modifies the Term Date of the PremRate to a date based on the enrollment of the member. Note: The database will apply a default value of NORMAL for this field if a value is not provided. - `data.tier` (string,null) Tier of the PremRate - `data.update_Date` (string) Date the record was last updated in the system - `data.update_User` (string,null) User that last updated the record in the system - `data.zip_Code_From` (string,null) Beginning Zip Code of the Address used to determine if the rate applies - `data.zip_Code_Thru` (string,null) Ending Zip Code of the Address used to determine if the rate applies - `error` (object) - `error.detail` (string,null) A human-readable explanation specific to this occurrence of the problem. - `error.instance` (string,null) A URI reference that identifies the specific occurrence of the problem.It may or may not yield further information if dereferenced. - `error.status` (integer) The HTTP status code([RFC7231], Section 6) generated by the origin server for this occurrence of the problem. - `error.title` (string,null) A short, human-readable summary of the problem type.It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization(e.g., using proactive content negotiation; see[RFC7231], Section 3.4). - `error.type` (string,null) A URI reference [RFC3986] that identifies the problem type. This specification encourages that, when dereferenced, it provide human-readable documentation for the problem type (e.g., using HTML [W3C.REC-html5-20141028]). When this member is not present, its value is assumed to be "about:blank". - `debug` (object) - `debug.activityID` (string, required) ## Response 401 fields