# Copy Premium Rates

Take a list of Rates and a set of configuration options and copy those rates.

Endpoint: POST /billing-rate-copy
Version: v1
Security: apiKeyAuth, bearerAuth

## Header parameters:

  - `vbasoftware-database` (string, required)
    Target database

## Request fields (application/json):

  - `rate_Basis` (string,null)
    Used in both Rate Copy and Rate Change

  - `keep_Rate_Basis` (boolean)
    Used in both Rate Copy and Rate Change

  - `rate_Category` (string,null)
    Used in both Rate Copy and Rate Change

  - `keep_Rate_Category` (boolean)
    Used in both Rate Copy and Rate Change

  - `plan_ID` (string,null)
    Used in both Rate Copy and Rate Change

  - `keep_Plan_ID` (boolean)
    Used in both Rate Copy and Rate Change

  - `group_ID` (string,null)
    Used in both Rate Copy and Rate Change

  - `keep_Group_ID` (boolean)
    Used in both Rate Copy and Rate Change

  - `division_ID` (string,null)
    Used in both Rate Copy and Rate Change

  - `keep_Division_ID` (boolean)
    Used in both Rate Copy and Rate Change

  - `premRate_Type` (string,null)
    Used in both Rate Copy and Rate Change

  - `rate_Option` (integer)
    Used in both Rate Copy and Rate Change
1 - Use Existing;
2 - Update Existing;
3 - Create New;

  - `payee_Option` (integer)
    Used in both Rate Copy and Rate Change
1 - Use Existing Rates;
2 - Create New Rates;
3 - Add;

  - `existing_Rate_Term_Date` (string,null)
    Used only with Rate Change

  - `new_Rate_Effective_Date` (string,null)
    Used only with Rate Change

  - `new_Rate_Term_Date` (string,null)
    Used only with Rate Change

  - `user_ID` (string,null)
    Used in both Rate Copy and Rate Change

  - `premRates` (array,null)
    Used in both Rate Copy and Rate Change

  - `premRates.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.

  - `premRates.add_On_Grouping_ID` (string,null)
    Used to identify Add On rates by Group

  - `premRates.additional_Invoice_Address` (string,null)
    Address the additional invoice is sent to

  - `premRates.additional_Invoice_Frequency` (string,null)
    Frequency of the additional invoice

  - `premRates.additional_Invoice_Level` (string,null)
    Allows split billing at this level

  - `premRates.address_Type` (string,null)
    Level of the Address used to determine if the rate applies

  - `premRates.adjustment_Reason` (integer,null)
    Adjustment Reason of the PremRate

  - `premRates.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.

  - `premRates.age_From` (integer,null)
    Beginning Age range of the PremRate

  - `premRates.age_Thru` (integer,null)
    Ending Age range of the PremRate

  - `premRates.age_Type` (string,null)
    Detemines what date is used to calculate Age

  - `premRates.age_Type_Month` (string,null)
    Detemines what Month is used if the Month Type is selected

  - `premRates.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.

  - `premRates.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.

  - `premRates.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.

  - `premRates.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.

  - `premRates.auto_Adjust_Reason` (integer,null)
    Reason applied to automatic adjustments

  - `premRates.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.

  - `premRates.benefit_Code` (string,null)
    Benefit Code of the PremRate

  - `premRates.billing_Cycle_ID` (string,null)
    This is the Billing Cycle the invoice was gerenated for.

  - `premRates.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.

  - `premRates.city` (string,null)
    City of the Address used to determine if the rate applies

  - `premRates.class_Code` (string,null)
    Class Code for the PremRate

  - `premRates.country_ID` (string,null)
    Country ID of the Address used to determine if the rate applies

  - `premRates.county_Code` (string,null)
    Country Code of the Address used to determine if the rate applies

  - `premRates.description` (string,null)
    Description of the PremRate

  - `premRates.division_ID` (string,null)
    Unique identifier for the Division

  - `premRates.effective_Date` (string,null)
    Effective Date of the PremRate

  - `premRates.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.

  - `premRates.employee_Employer_Contribution` (string,null)
    Determines if the contribution is Employee or Employer

  - `premRates.employer_Contribution` (number,null)
    Amount of the contribution

  - `premRates.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.

  - `premRates.employer_Rate` (number,null)
    Decimal value that defines the base employer rate

  - `premRates.employer_Rate_Max` (number,null)
    Maximum the employer rate will be regardless of the calculation

  - `premRates.employer_Rate_Minimum` (number,null)
    Minimum the employer rate will be regardless of the calculation

  - `premRates.employer_Rate_Type` (string,null)
    Type of Employer Rate

  - `premRates.employer_Rate_Variable1` (number,null)
    First variable used in calculating the employer rate based on the type

  - `premRates.employer_Rate_Variable2` (number,null)
    Second variable used in calculating the employer rate based on the type

  - `premRates.employer_Rate_Variable3` (number,null)
    Third variable used in calculating the employer rate based on the type

  - `premRates.employer_Round_Precision` (integer,null)
    Precision that the employerrate is rounded to

  - `premRates.employer_Round_Type` (string,null)
    Type that determine how the employer rate is rounded

  - `premRates.enrolled_Count_From` (integer,null)
    Beginning range based on number of enrollments

  - `premRates.enrolled_Count_Thru` (integer,null)
    Ending range based on number of enrollments

  - `premRates.enrolled_Count_Type` (string,null)
    Type of enrollments used to calculate the number of enrollments

  - `premRates.enrolled_Duration_From` (integer,null)
    Beginning range based on length of enrollment

  - `premRates.enrolled_Duration_Min` (integer,null)
    Minimum length of enrollment

  - `premRates.enrolled_Duration_Option` (string,null)
    Determines if the date is based on the Member or the Plan enrollment

  - `premRates.enrolled_Duration_Thru` (integer,null)
    Ending range based on length of enrollment

  - `premRates.enrolled_Duration_Type` (string,null)
    Type of date used to determine the enrollment range

  - `premRates.entry_Date` (string)
    Date record was first added to the system

  - `premRates.entry_User` (string,null)
    User that first added the record to the system

  - `premRates.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.

  - `premRates.group_ID` (string,null)
    Unique identifier for the Group

  - `premRates.member_Seq` (string,null)
    Unique sequence for a Member

  - `premRates.network_ID` (string,null)
    Unique identifier for the Network

  - `premRates.network_Type` (string,null)
    Type of Network

  - `premRates.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.

  - `premRates.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.

  - `premRates.parent_PremRate_Key` (integer,null)
    PremRate_Key of the template rate this rate was created from

  - `premRates.payment_Method` (string,null)
    The primary key of the payment method

  - `premRates.plan_ID` (string,null)
    Unique identifier for the Plan

  - `premRates.plan_Type` (string,null)
    Type of Plan

  - `premRates.premRate_Basis` (string,null)
    Basis of the PremRate

  - `premRates.premRate_Category` (string,null)
    Category of the PremRate

  - `premRates.premRate_ID` (string,null)
    Unique identifier for the PremRate

  - `premRates.premRate_Type` (string,null)
    Type of the PremRate

  - `premRates.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.

  - `premRates.rate` (number,null)
    Decimal value that defines the base rate

  - `premRates.rate_Max` (number,null)
    Maximum the rate will be regardless of the calculation

  - `premRates.rate_Minimum` (number,null)
    Minimum the rate will be regardless of the calculation

  - `premRates.rate_Pace` (string,null)
    How often the rate applies

  - `premRates.rate_Pace_Type` (string,null)
    The day the rate applies when the pace is weekly

  - `premRates.rate_Round_Precision` (integer,null)
    Precision that the rate is rounded to

  - `premRates.rate_Round_Type` (string,null)
    Type that determine how the rate is rounded

  - `premRates.rate_Type` (string,null)
    Type of Rate

  - `premRates.rate_Variable1` (number,null)
    First variable used in calculating the rate based on the type

  - `premRates.rate_Variable2` (number,null)
    Second variable used in calculating the rate based on the type

  - `premRates.rate_Variable3` (number,null)
    Third variable used in calculating the rate based on the type

  - `premRates.region_Code` (string,null)
    Region Code of the Address used to determine if the rate applies

  - `premRates.relationship` (string,null)
    Relationship for the PremRate

  - `premRates.sex` (string,null)
    Flag used to determine what Sex the rate applies to

  - `premRates.smoker` (string,null)
    Flag to determine if the rate applies to Smokers

  - `premRates.state` (string,null)
    State of the Address used to determine if the rate applies

  - `premRates.subscriber_ID` (string,null)
    Unique identifier for the Subscriber

  - `premRates.term_Date` (string,null)
    Term Date of the PremRate

  - `premRates.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.

  - `premRates.tier` (string,null)
    Tier of the PremRate

  - `premRates.update_Date` (string)
    Date the record was last updated in the system

  - `premRates.update_User` (string,null)
    User that last updated the record in the system

  - `premRates.zip_Code_From` (string,null)
    Beginning Zip Code of the Address used to determine if the rate applies

  - `premRates.zip_Code_Thru` (string,null)
    Ending Zip Code of the Address used to determine if the rate applies

  - `premRatePayees` (array,null)
    Used in both Rate Copy and Rate Change

  - `premRatePayees.premRate_Key` (integer, required)

  - `premRatePayees.payee_ID` (string, required)

  - `premRatePayees.account_Key` (integer,null)

  - `premRatePayees.amount` (number,null)

  - `premRatePayees.amount_Max` (number,null)

  - `premRatePayees.amount_Pct` (boolean, required)

  - `premRatePayees.dist_Type` (string,null)

  - `premRatePayees.entry_Date` (string)

  - `premRatePayees.entry_User` (string,null)

  - `premRatePayees.payor_ID` (string,null)

  - `premRatePayees.policy_Number` (string,null)

  - `premRatePayees.premRate_Category` (string,null)

  - `premRatePayees.priority` (integer,null)

  - `premRatePayees.rate` (number,null)

  - `premRatePayees.rate_Max` (number,null)

  - `premRatePayees.rate_Min` (number,null)

  - `premRatePayees.rate_Round_Precision` (integer,null)

  - `premRatePayees.rate_Round_Type` (string,null)

  - `premRatePayees.rate_Var1` (number,null)

  - `premRatePayees.rate_Var2` (number,null)

  - `premRatePayees.rate_Var3` (number,null)

  - `premRatePayees.update_Date` (string)

  - `premRatePayees.update_User` (string,null)


## Response 202 fields

## Response 401 fields