Wex Health and Benefits APIs

Sections

Theme switcher

Get Agreements Agreements

Header Parameters

X-Request-Idstring

Optional correlation ID.

Authorizationstring

Query Parameters

custodian_idinteger

Optional. Filter to agreements owned by this custodian.

administrator_idinteger

Optional. Filter to agreements scoped to this administrator.

doc_typeinteger

Optional. Filter by document type (0 = Agreement, 1 = Guide).

activeboolean

Optional. When true, return only active agreements; false returns retired ones.

has_fileboolean

Optional. When true, return only agreements that have at least one active file.

include_admin_propertiesboolean

Optional. When true, each result includes the owning custodian ID and scoped administrator ID.

Response

200
Object

Agreements returned successfully.

Response Attributes

itemsarray | null

Show child attributes

pageinteger
page_sizeinteger
has_nextboolean
paginationobject | null

Show child attributes

400
Object

One or more query parameters are invalid.

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.

401
Object

Bearer token is missing or invalid.

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

Caller token does not resolve to a known customer shard.

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

No agreements found for the supplied filter combination within the caller scope.

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.

Was this section helpful?

GET

/

Select
1

Response

Was this section helpful?