Wex Health and Benefits APIs

Sections

Theme switcher

Get Agreements Agreement

Header Parameters

X-Request-Idstring

Optional correlation ID.

Authorizationstring

Query Parameters

include_admin_propertiesboolean

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

Path Parameters

agreementIdinteger Required

The agreement to retrieve.

Response

200
Object

Agreement returned successfully.

Response Attributes

agreement_idinteger

Primary key.

agreement_namestring | null

Display name.

doc_typeinteger

Document type: 0 = Agreement, 1 = Guide.

activeboolean

true = active; false = retired.

effective_datestring

Date from which the agreement is in effect.

current_definitionobject | null

Show child attributes

has_fileboolean

true if at least one active file is associated with this agreement.

filesarray | null

Active files attached to this agreement, newest first.

Show child attributes

custodian_idinteger | null

ID of the owning custodian. null unless include_admin_properties=true.

administrator_idinteger | null

ID of the scoped administrator. null unless include_admin_properties=true.

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

Agreement not found.

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?