# Create or Update Batch ProviderWithhold

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

Endpoint: PUT /provider-withholds-batch
Version: v1
Security: apiKeyAuth, bearerAuth

## Header parameters:

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

## Request fields (application/json):

  - `providerWithhold_Key` (integer, required)
    Unique identifier for each Withhold setting.

  - `account_Key` (integer,null)
    This field indicates the funding account criteria by which the withhold is applied to a claim.

  - `benefit_Code` (string,null)
    Benefit code required for adjudication matching.

  - `effective_Date` (string, required)
    Start of the range of acceptable service dates for the admin fee.

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

  - `ex_Code` (string,null)
    Ex code associated with the price line.

  - `federal_ID` (string,null)
    Allows setting the Tax ID that this withhold will apply when applying a withhold across multiple Providers.

  - `network_ID` (string,null)
    Identifies the required Network for adjudication matching.

  - `payor_ID` (string,null)
    This field indicates the payor criteria by which the withhold is applied to a claim.

  - `provider_ID` (string,null)
    The Provider ID this Withhold setting is being applied.

  - `term_Date` (string,null)
    End of the range of acceptable service dates for the admin fee.

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

  - `withhold` (number,null)
    Shows the withheld percentage.

  - `withhold_Max` (number,null)
    Indicates the max Withhold that can be taken for this withhold configuration.

  - `withhold_Pct` (boolean, required)
    Indicates if the Withhold value on this table is a Percentage or a Flat amount.

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