Wex Health and Benefits APIs

Sections

Theme switcher

Create Claim Draft

Header Parameters

X-Request-Idstring

Optional correlation ID associated with the request, comprised of alphanumeric or hyphen characters up to 36 characters in length.

Query Parameters

person_idstring Required

Platform GUID of the participant.

Body Parameters

plan_idstring Required

Plan GUID identifying the benefits offering.

service_start_datestring Required

The service start date for the claim.

service_end_datestring

The service end date for the claim. Defaults to service start date if not provided.

service_categorystring Required

The expense category (e.g. Medical, Dental, Vision).

Max length
100
service_typestring Required

The expense type within the category (e.g. Prescription).

Max length
100
service_descriptionstring

Optional description of the service.

Max length
2000
service_recipientstring

Name of the service recipient (participant or dependent name).

Max length
1000
providerstring

Name of the provider (e.g. CVS Pharmacy).

Max length
100
provider_numberstring

Provider NPI or reference number.

Max length
20
claim_amountnumber Required

The total amount being claimed.

mileage_amountinteger

Mileage reimbursement amount in dollars.

miles_travelledinteger

Number of miles travelled for the service.

mileage_ratenumber

Mileage rate per mile used for reimbursement calculation.

receipt_requiredboolean

Whether a receipt is required for this claim.

participant_commentsstring

Optional comments from the participant.

Max length
4000
is_duplicateboolean

Whether this claim is a duplicate of an existing claim.

need_reviewboolean

Whether this claim needs manual review.

has_split_claimsboolean

Whether this claim has been split into multiple claims.

image_idstring

Optional document image ID linked to this claim.

Max length
200
receive_date_specifiedboolean

Whether the received date was explicitly specified by the caller.

claim_recurrence_request_flagboolean

Whether this is a recurring claim request.

received_datestring

The date the claim was received. Defaults to today if not specified.

eligible_expense_idinteger Required

Eligible expense ID for the selected expense type. Must be valid for the specified plan.

admin_deny_amountnumber

Amount denied by an administrator.

expense_amountnumber

Total expense amount for this claim.

recipientsarray Required

Recipients for this expense (participant, dependents, or external recipients).

Show child attributes

alternate_payeeobject

Show child attributes

Response

201
Object

Draft created successfully.

Response Attributes

provisional_order_numberstring

Gets or sets the provisional order number associated with the worksheet.

worksheet_system_idstring

Gets or sets the stable system GUID for this worksheet (ClaimWorksheetExternal_guid). Pass this value as the {worksheet_id} route parameter when calling PUT /v1/claims/worksheets/{worksheet_id} or POST /v1/claims/{worksheet_id}/file-claim.

statusstring

Gets or sets the status of the worksheet.

created_atstring

Gets or sets the creation date and time of the worksheet.

valid_untilstring

Gets or sets the date and time until which the worksheet is valid.

submissionsarray

Gets or sets the list of submissions within the worksheet.

Show child attributes

400
Object

Invalid request.

Response Attributes

typestring
titlestring
statusinteger
detailstring
instancestring
errorsobject

Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.

validation_errorsobject

Field-level validation errors keyed by field name. Each key maps to one or more structured error details.

401
Object

Unauthorized.

Response Attributes

typestring
titlestring
statusinteger
detailstring
instancestring
errorsobject

Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.

validation_errorsobject

Field-level validation errors keyed by field name. Each key maps to one or more structured error details.

500
Object

Internal server error.

default
Object

Unexpected error

Response Attributes

typestring
titlestring
statusinteger
detailstring
instancestring
errorsobject

Human-readable validation error messages keyed by field name. Each key maps to one or more error message strings.

validation_errorsobject

Field-level validation errors keyed by field name. Each key maps to one or more structured error details.

Was this section helpful?

Base URL

Production:

Sandbox:

Language Box

POST

/

Select
1

Response

Was this section helpful?