Create Expense

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

The GUID of the person creating the expense.

The name/description of the expense (3–25 chars). Validation enforced by the handler.

The date the service was provided.

The expense amount as a decimal string (e.g., "125.50"). Must be greater than 0.

The total billed amount as a decimal string. Must be greater than 0 and greater than or equal to ExpenseAmount when provided.

The expense category (optional). Values mirror the Configger DB constants from stm.usp_SelectExpenseCategories. When null, defaults to WEX.Benefits.Claims.Domain.Enums.ExpenseCategory.Other.

The provider/payee name (max 100 chars).

List of recipients/patients associated with the expense (max 50).

Additional notes for the expense (max 4000 chars).

List of pre-uploaded receipt documents to attach (max 4).

The unique GUID tracking number for the expense.

The status of the created expense. For this endpoint, newly created consumer-tracked expenses are returned with a status of "UNPAID".

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

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

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

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

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

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

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

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