Signing via Bank iD (API)

A signer can sign using Bank iD — they sign with their bank identity, and their verification is carried out by logging in to their bank. All you need to do is set the role sign_bank_id_sign for them.

This method must be enabled in the workspace and is a paid feature — arrange it with your contact at Signi. See Signing roles.

Example

{
    "people": [
        { "is_proposer": true, "email": "vas@email.cz", "contract_role": "approve" },
        { "is_proposer": false, "email": "protistrana@email.cz", "contract_role": "sign_bank_id_sign",
          "first_name": "Jan", "last_name": "Novák", "person_type": "nature",
          "positions": [ { "x": 50, "y": 80, "page": 0 } ] }
    ],
    "file": "uploaded_file_key"
}

curl -X POST "https://api.signi.com/api/v1/contract/" \
  -H "x-api-key: VAS_API_KLIC" \
  -F "data=@dokument.json;type=application/json" \
  -F "uploaded_file_key=@dokument.pdf"

The response is the same as for a regular creation (contract_id, notifications with links). The difference is on the signer's side — in the signing wizard, Signi guides them through signing via their bank.

Where to go next

• Signing with a certificate — another higher-level signing method
• Signing roles — who does what with the document