# Create PlanBenefitLevel

Creates a new PlanBenefitLevel

Endpoint: POST /plans/{planID}/benefits/{benefitCode}/levels
Version: v1
Security: apiKeyAuth, bearerAuth

## Header parameters:

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

## Path parameters:

  - `planID` (string, required)
    Plan ID

  - `benefitCode` (string, required)
    Benefit Code

## Request fields (application/json):

  - `planBenefitLevel_Key` (integer, required)
    Unique idenfitier assigned to the Plan Benefit Level. Note: This field is marked as NOT NULL in the database and therefore required by the API.

  - `benefit_Code` (string, required)
    References the PlanBenefits.Benefit_Code value in parent table.

  - `benefit_Level` (string, required)
    Unique identifier assigned to the Plan Benefit Level: Age by Service Date - age of the Member by the service date of the claim. Age by Received Date - age of the Member by the received date of the claim. Relationship Code - relationship of the Member to the Subscriber. Months Enrolled in Plan - range of months the Member has been enrolled in the plan. Days Enrolled in Plan - range of days the Member has been enrolled in the plan. Network - network of the claim. Out of Network - claim is out of network. Billed Amount - range of billed amount of the service line. Modifier - modifier exists on the service line. Exact Modifier - modifier exists in the exact location on the service line. No Modifier - no modifier exists on the service line. Exclude Modifier - modifier does not exist on the service line. Exclude Exact Modifier - modifier does not exist in the exact location on the service line. Gender - biological sex of the Member. Billing Taxonomy - taxonomy of the billing Provider must be included in the taxonomy group. Rendering Taxonomy - taxonomy of the rendering Provider must be included in the taxonomy group. Service Facility Taxonomy - taxonomy of the facility Provider must be included in the taxonomy group. Procedure Category - procedure code on the service line must fall into the indicated procedure category. Procedure Cluster - procedure code on the service line must fall into the indicated procedure cluster. Provider Federal ID - federal ID of the claim's Provider.

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

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

  - `exclude` (boolean, required)
    Indicates whether the specified code is included or excluded. Note: This field is marked as NOT NULL in the database and therefore required by the API.

  - `extra_Value1` (string,null)
    Additional value that may be associated with the Benefit Level.

  - `extra_Value2` (string,null)
    Additional value that may be associated with the Benefit Level.

  - `from_Value` (string,null)
    Initial value in the range of values.

  - `plan_ID` (string,null)
    References the PlanBenefits.Plan_ID value in parent table.

  - `thru_Value` (string,null)
    Final value in the range of values.

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

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

  - `value_Type` (string,null)
    Specifies the type or measure of the associated Benefit Level values.

## Response 200 fields (text/plain):

  - `data` (object)

  - `data.planBenefitLevel_Key` (integer, required)
    Unique idenfitier assigned to the Plan Benefit Level. Note: This field is marked as NOT NULL in the database and therefore required by the API.

  - `data.benefit_Code` (string, required)
    References the PlanBenefits.Benefit_Code value in parent table.

  - `data.benefit_Level` (string, required)
    Unique identifier assigned to the Plan Benefit Level: Age by Service Date - age of the Member by the service date of the claim. Age by Received Date - age of the Member by the received date of the claim. Relationship Code - relationship of the Member to the Subscriber. Months Enrolled in Plan - range of months the Member has been enrolled in the plan. Days Enrolled in Plan - range of days the Member has been enrolled in the plan. Network - network of the claim. Out of Network - claim is out of network. Billed Amount - range of billed amount of the service line. Modifier - modifier exists on the service line. Exact Modifier - modifier exists in the exact location on the service line. No Modifier - no modifier exists on the service line. Exclude Modifier - modifier does not exist on the service line. Exclude Exact Modifier - modifier does not exist in the exact location on the service line. Gender - biological sex of the Member. Billing Taxonomy - taxonomy of the billing Provider must be included in the taxonomy group. Rendering Taxonomy - taxonomy of the rendering Provider must be included in the taxonomy group. Service Facility Taxonomy - taxonomy of the facility Provider must be included in the taxonomy group. Procedure Category - procedure code on the service line must fall into the indicated procedure category. Procedure Cluster - procedure code on the service line must fall into the indicated procedure cluster. Provider Federal ID - federal ID of the claim's Provider.

  - `data.entry_Date` (string)
    Date when the record was added to the system.

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

  - `data.exclude` (boolean, required)
    Indicates whether the specified code is included or excluded. Note: This field is marked as NOT NULL in the database and therefore required by the API.

  - `data.extra_Value1` (string,null)
    Additional value that may be associated with the Benefit Level.

  - `data.extra_Value2` (string,null)
    Additional value that may be associated with the Benefit Level.

  - `data.from_Value` (string,null)
    Initial value in the range of values.

  - `data.plan_ID` (string,null)
    References the PlanBenefits.Plan_ID value in parent table.

  - `data.thru_Value` (string,null)
    Final value in the range of values.

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

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

  - `data.value_Type` (string,null)
    Specifies the type or measure of the associated Benefit Level values.

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