Wex Health and Benefits APIs

Sections

Theme switcher

List Transactions

Header Parameters

X-Request-Idstring

Optional correlation ID associated with the request.

Authorizationstring

Query Parameters

plan_year_idstring

Filter by plan year ID. Optional; when omitted, transactions across all available plan years for the consumer are returned.

plan_idstring

Filter by plan ID

number_of_transactionsinteger

Maximum number of transactions to be returned by plan(default: 200).

Default value
200
start_datestring

The start date to fetch transactions for. Required if number_of_transactions is 0.

end_datestring

The end date to fetch transactions for. Required if number_of_transactions is 0.

include_running_balanceboolean

Determines if the running balance will be included in the response call.

Default value
false
page_sizeinteger

Maximum number of rows to return per page (1-100).

Minimum
1
Maximum
100
Default value
20
pageinteger

Zero-based page index.

Default value
0

Path Parameters

consumer_idstring Required

Filter by consumer ID. Required.

Response

200
Object

Transactions retrieved successfully.

Response Attributes

itemsarray Required

The list of data items for the current page.

Max items
100

Show child attributes

paginationobject Required

Show child attributes

400
Object

Bad Request – Validation failed. The errors map keys mirror the snake_case JSON property names used in the request payload.

Response Attributes

typestring | null
titlestring | null
statusinteger | null
detailstring | null
instancestring | null
invalid_paramsarray | null

List of invalid parameters that caused the validation error.

Max items
10

Show child attributes

errorsobject

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

Show child attributes

validation_errorsobject

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

401
Object

Unauthorized – Missing or invalid credentials.

Response Attributes

typestring | null
titlestring | null
statusinteger | null
detailstring | null
instancestring | null
invalid_paramsarray | null

List of invalid parameters that caused the validation error.

Max items
10

Show child attributes

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.

404
Object

Not Found – Employee record does not exist.

Response Attributes

typestring | null
titlestring | null
statusinteger | null
detailstring | null
instancestring | null
invalid_paramsarray | null

List of invalid parameters that caused the validation error.

Max items
10

Show child attributes

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.

Response Attributes

typestring | null
titlestring | null
statusinteger | null
detailstring | null
instancestring | null
invalid_paramsarray | null

List of invalid parameters that caused the validation error.

Max items
10

Show child attributes

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.

default
Object

Unexpected error

Response Attributes

typestring | null
titlestring | null
statusinteger | null
detailstring | null
instancestring | null
invalid_paramsarray | null

List of invalid parameters that caused the validation error.

Max items
10

Show child attributes

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.

403
Object

Forbidden – Insufficient permissions.

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?

GET

/

Select
1

Response

Was this section helpful?