Skip to main content

List who can approve

GET 
/approvals/eligible-approvers

Tells whether a manager approval is needed at the outlet in X-Outlet-ID for the asked types, which rule applies (policy) and who can give it. The acting user does not need an open shift for this read; the PIN and one-time code calls do.

Request​

  • Send types as a comma list, for example types=refund,return.

Behaviour​

  • policy is the strictest one across the asked types: pin, otp_preferred or otp_only.
  • When is_enabled is false no approval is needed and approvers is empty.
  • An approver's phone number is never returned: can_receive_otp says whether a one-time code can reach the approver, and otp_unavailable_reason says why not.

Errors​

StatusCodeWhen
400VALIDATION_FAILEDtypes is missing or has an unknown value.
400USER_ID_REQUIREDX-User-ID is missing.
403PERMISSION_DENIEDThe acting user may not do this.
403OUTLET_FORBIDDENThe outlet is not allowed.
422INVALID_USERThe acting user is not valid.

Request​

Responses​

The approval line