Version 1.30.0
Tvarka Formos asks a person to fill in forms on their own phone and sign them once. Tablet sessions collect a drawn signature at the desk. Both are part of Tvarka Sign.
Pick a published form, prefill the known fields and send the request. The values come back when the person has submitted the form.
BASE=https://sign-api.tvarka.pro
# TVARKA_KEY holds your API key.
curl -sS "$BASE/v1/form-templates" \
-H "Authorization: Bearer $TVARKA_KEY"
A form request asks one person to fill one or more published form templates on their own phone and sign them once, as one document, with a qualified signature by Smart-ID or Mobile-ID (v1.16.0). Templates are built in the Tvarka Sign app (Formos) from the business's own PDF, or adopted from the statutory library; every published version carries its legal basis.
GET /v1/form-templates lists the published versions with their
fields, each under its semantic identifier (person.given_name).
POST /v1/form-requests takes templateVersionIds, the
respondent (phone for an SMS link and code, or
email), visitAt, prefill by semantic
identifier, an optional personalCode (only that person's signature
is accepted), externalId, webhookUrl and an
Idempotency-Key. The link goes out three days before the visit,
at sendAt, or at once with sendNow; one reminder
goes out a day before the visit, and the request expires a day after it.
GET /v1/form-requests/{formRequestId} returns the status, the
events and, once submitted, the values. PATCH with
visitAt, resend or cancel changes it
without a second submission. The signed PDF is at /document, an
evidence ZIP at /evidence and the attachments at
/attachments. Webhooks form_request.opened,
submitted, completed, cancelled,
expired and failed reach the request's
webhookUrl and the workspace's webhook subscriptions;
completed carries the values and the document link. MCP:
list_form_templates, send_forms,
get_form_request. A completed request is charged as one
e-signature document, plus the qualified signature and the SMS codes as on
any signing.
A tablet at your desk is registered in Tvarka Sign under Planšetės and paired with an eight-letter code. A person then reads a document on it and signs by hand (v1.15.0). The drawn signature is sealed into the PDF with its pen data, and the round gets a qualified document timestamp.
GET /v1/kiosks lists the tablets with paired,
online and busy. POST /v1/kiosk-sessions
takes kioskId, a title and one PDF in
document, through the same intake as a signing
(content, fileToken, url or
markdown). No link is mailed. signer.name may be left
empty, so the person types it on the tablet. signer.email receives
the signed PDF. identity: sms sends a one-time code to
signer.phone and checks it on the tablet first. A busy tablet
answers 409.
product: forms with formRequestId sends a Tvarka
Formos request to the tablet instead (v1.17.0). The person fills the form on
the tablet and signs it there. A staff signature place, such as the doctor's,
is signed next on the same tablet.
GET /v1/kiosk-sessions/{kioskSessionId} follows the session
from waiting to completed. PATCH with
assisted: true lets a staff member fill fields from a computer
while the tablet shows them, and status: cancelled withdraws the
document. Once completed, /document returns the signed PDF and
referenceCode its public check code. One round is charged once,
as one e-signature document (EUR 0.13, excluding VAT), however many
people sign on the tablet.
Questions: info@tvarka.pro