Wex Health and Benefits APIs

Update Denial

Updates the specified Denial for a claim by changing the denial status, reallocating denied amounts, or updating associated repayments. Returns the updated Denial object with the new claim status. Each denial is uniquely identified by denial_id.

Header Parameters

Idempotency-Keystring Required

Unique identifier for idempotent requests (UUID v4)

X-Request-Idstring

Optional correlation ID associated with the request.

Authorizationstring

Path Parameters

claim_numberstring Required

The unique identifier of the claim.

denial_idstring Required

The denial id associated with a claim to update.

Body Parameters

reallocate_to_pending_amountstring

Non-negative monetary amount represented as a decimal string with exactly two fractional digits. Must not exceed system-supported maximum values.

Max length

15

Pattern

^(0|[1-9][0-9]*)\.[0-9]{2}$

reallocate_to_paid_amountstring

Non-negative monetary amount represented as a decimal string with exactly two fractional digits. Must not exceed system-supported maximum values.

Max length

15

Pattern

^(0|[1-9][0-9]*)\.[0-9]{2}$

reallocate_to_deductible_applied_amountstring

Non-negative monetary amount represented as a decimal string with exactly two fractional digits. Must not exceed system-supported maximum values.

Max length

15

Pattern

^(0|[1-9][0-9]*)\.[0-9]{2}$

reallocate_to_coinsurance_applied_amountstring

Non-negative monetary amount represented as a decimal string with exactly two fractional digits. Must not exceed system-supported maximum values.

Max length

15

Pattern

^(0|[1-9][0-9]*)\.[0-9]{2}$

reallocate_to_copay_applied_amountstring

Non-negative monetary amount represented as a decimal string with exactly two fractional digits. Must not exceed system-supported maximum values.

Max length

15

Pattern

^(0|[1-9][0-9]*)\.[0-9]{2}$

Response

200

Object

Successfully updated the denial.

Response Attributes

claim_numberstring Required

The claim number whose status was updated.

denial_idstring Required

Unique identifier associated with the claim denial record impacted by the status update.

repayment_idstring

Unique identifier associated with a repayment record affected by the claim status update. Returned as null when no repayment is applicable.

Nullable:

True

claim_statusstring Required

Enumeration of possible claim statuses.

denial_updated_timestampstring Required

Timestamp when the claim status was updated.

messagestring

Additional details regarding the claim status update.

400

Object

Bad Request

Response Attributes

typestring

Nullable:

True

titlestring

Nullable:

True

statusinteger

Nullable:

True

detailstring

Nullable:

True

instancestring

Nullable:

True

401

Object

Unauthorized

Response Attributes

typestring

Nullable:

True

titlestring

Nullable:

True

statusinteger

Nullable:

True

detailstring

Nullable:

True

instancestring

Nullable:

True

403

Object

Forbidden

Response Attributes

typestring

Nullable:

True

titlestring

Nullable:

True

statusinteger

Nullable:

True

detailstring

Nullable:

True

instancestring

Nullable:

True

404

Object

Not Found

Response Attributes

typestring

Nullable:

True

titlestring

Nullable:

True

statusinteger

Nullable:

True

detailstring

Nullable:

True

instancestring

Nullable:

True

503

Object

Service Unavailable

Response Attributes

typestring

Nullable:

True

titlestring

Nullable:

True

statusinteger

Nullable:

True

detailstring

Nullable:

True

instancestring

Nullable:

True

default

Object

Unexpected error

Response Attributes

typestring

Nullable:

True

titlestring

Nullable:

True

statusinteger

Nullable:

True

detailstring

Nullable:

True

instancestring

Nullable:

True