Skip to main content

Approvers

The approvers list (approvers on bankReport) describes who must sign the package and where each signatory is in the signing flow.

Shape​

Each Approver carries:

  • id
  • bankReport — back‑reference to the parent report.
  • administrator — the administrator (board member or external administrator) acting as signatory. May be null if the approver is not yet a fully accepted administrator.
  • administratorInvitation — the pending invitation, when the signatory has not yet accepted membership.
  • isLegitimationRequired — true when the signatory must complete identity legitimation in addition to signing.
  • isSignatureRequired — true when the signatory must produce a digital signature on the package.
  • signatoryInformation — state and signatureTime.

Signing state​

signatoryInformation.state is the ApproverState enum:

  • PENDING — no signature yet.
  • SIGNED — signature collected.
  • REJECTED — the signatory refused to sign.
  • ERROR — the signing flow failed.
  • EXEMPT — this approver is not required to sign on this package.

signatureTime is set when state becomes SIGNED.

Bank reports for companies​

A bank report for a company (organization.discriminator is "Company") has exactly one approver: the administrator who signed it for the company. administrator resolves that person through the same types as administrator changes: an internal administrator as a BoardMember, an external administrator as an ExternalAdministrator. Your ... on BoardMember and ... on ExternalAdministrator fragments match unchanged. administratorInvitation is null and isLegitimationRequired is false.

Where to query​

See Querying approvers. A package can't be rejected purely because of a signing‑flow problem — if a signatory has refused or the flow has errored, follow up with the customer rather than rejecting the package.