# Create or Update Batch MemberBeneficiary

Create or Update multiple MemberBeneficiary at once.  If the entity exists, it will be updated.  If the entity does not exist, it will be created.

Endpoint: PUT /subscribers/{subscriberID}/members/{memberSeq}/beneficiaries-batch
Version: v1
Security: apiKeyAuth, bearerAuth

## Header parameters:

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

## Path parameters:

  - `subscriberID` (string, required)
    Subscriber ID

  - `memberSeq` (string, required)
    Member Seq

## Request fields (application/json):

  - `subscriber_ID` (string, required)
    References Members.Subscriber_ID value on the parent record.

  - `member_Seq` (string, required)
    References Members.Member_Seq value on the parent record.

  - `beneficiary_ID` (string,null)
    Unique identifier for this beneficiary on this member.

  - `address` (string,null)
    Primary address of the Beneficiary.

  - `address2` (string,null)
    Address line 2 of the Beneficiary's primary address.

  - `assignment` (number,null)
    A set amount paid to a beneficiary.

  - `city` (string,null)
    City of the Beneficiary's primary address.

  - `country_ID` (string,null)
    Identifier of the country of the Beneficiary's primary address.

  - `date_Of_Birth` (string,null)
    Date of birth of the Beneficiary.

  - `end_Date` (string,null)
    End date of the Beneficiary's status.

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

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

  - `exclude_Interest` (boolean, required)
    Indicates if interest should be excluded when adjudicating Life claims paid to this beneficiary.  Note: The database will apply a default value of False for this field if a value is not provided.  This field is also marked as NOT NULL in the database and therefore required by the API.  If you do not have a value for this field, supply the database default value of False to meet the API requirements and ensure that the functionality occurs as expected.

  - `first_Name` (string,null)
    First name of the Beneficiary.

  - `last_Name` (string,null)
    Last name of the Beneficiary.

  - `long_Name` (string,null)
    Full name of the Beneficiary.

  - `middle_Name` (string,null)
    Middle name of the Beneficiary.

  - `percentage` (number,null)
    Percentage of the benefit that is allotted to the associated Beneficiary.

  - `primary_Beneficiary` (boolean,null)
    Indicates whether the associated Beneficiary is the primary Beneficiary.

  - `relationship` (string,null)
    Relationship of the Beneficiary to the Member.

  - `ssn` (string,null)
    Social security number of the Beneficiary.

  - `secondary_Beneficiary` (boolean,null)
    This flag indicates if this beneficiary is secondary.

  - `start_Date` (string,null)
    Start date of the Beneficiary's status.

  - `state` (string,null)
    State of the Beneficiary's primary address.

  - `tertiary_Beneficiary` (boolean,null)
    This flag indicates if this tertiary is secondary.

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

  - `zip` (string,null)
    Zip code of the Beneficiary's primary address.

## Response 207 fields (text/plain):

  - `data` (array,null)

  - `data.id` (array, required)
    List of key/value pairs that represent the unique id for the entity operation.

  - `data.id.key` (string,null)

  - `data.id.value` (any,null)

  - `data.status` (integer, required)
    http status of the operation (eg, 200, 201, 500)

  - `data.body` (string, required)
    operation message (eg, Updated, Created, Error message)

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