How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Tvarka Sign API

Machine channel for Tvarka Sign: post a document and a list of signers and Tvarka runs its ordinary qualified signing ceremony for each of them on the hosted page or in the Tvarka Sign mobile app (LT ATK over NFC, Smart-ID, Mobile-ID). Nothing in the API signs anything - a signature is always a human act with the signer's own eID - so every operation is about getting a document in front of the right person and learning what they did. Orchestration sibling of the card-level ATK API; RFC 9457 problem details, HMAC-signed webhooks, and a hosted MCP server.

Tvarka Sign API is one of 10 APIs that Tvarka ATK API publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Digital Signature, QES, eIDAS, Lithuania, and OpenAPI. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and rate-limit docs.

This API exposes 21 operations across 15 paths, organized into 3 resource areas, and defines 14 schemas. It is described by OpenAPI 3.1.0, at version 1.2.1.

Requests are made against a single base URL, https://sign-api.tvarka.pro.

21 operations 15 paths 14 schemas 3 DELETE6 GET2 PATCH10 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.2.1
Base URL
https://sign-api.tvarka.pro
Authentication
HTTP Bearer
Contact
Resource Areas
3

Authentication & Security 1

Tvarka Sign API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — Authorization: Bearer . Keys are provisioned by Tvarka during onboarding and shown once. A tsklive key acts on production; a tsktest key is the sandbox. The ke…

Paths & Operations 21

Across 15 paths, the API surfaces 21 operations — 3 DELETE, 6 GET, 2 PATCH, 10 POST. They span 3 resource areas: Signings, Batches, Files. Each is listed below with its method, path, parameters, and response codes.

Signings 16

Create and follow a signing.

GET
/v1/signings
List signings
listSignings 3 params → 429200400401
POST
/v1/signings
Create a signing
createSigning body → 201400401402403422429503
GET
/v1/signings/{signingId}
Get a signing
getSigning 1 param → 401429200404
PATCH
/v1/signings/{signingId}
Update a live signing deadline
updateSigning 1 param body → 401429200400404409
DELETE
/v1/signings/{signingId}
Erase one signing
eraseSigning 1 param → 401429200404503
POST
/v1/signings/{signingId}/archive
Raise the signed output to a long-term level
archiveSigning 1 param → 401429200404409422
GET
/v1/signings/{signingId}/comments
Read the notes on a signing
listComments 1 param → 401429200404
POST
/v1/signings/{signingId}/comments
Add a note to a signing
addComment 1 param body → 401429201400404
POST
/v1/erasure
Erase terminal signings in bulk
eraseSignings body → 401429200400
POST
/v1/signings/{signingId}/cancel
Cancel a signing
cancelSigning 1 param → 401429200404409
GET
/v1/signings/{signingId}/document
Download the signed document
downloadSignedDocument 1 param → 401429200404409
POST
/v1/signings/{signingId}/signers
Add a signer to a live signing
addSigner 1 param body → 401429201400402404409
PATCH
/v1/signings/{signingId}/signers/{signerId}
Update a pending signer's allowed methods
updateSignerMethods 2 params body → 401429200400404409
DELETE
/v1/signings/{signingId}/signers/{signerId}
Remove a pending signer
removeSigner 2 params → 401429204404409
POST
/v1/signings/{signingId}/signers/{signerId}/remind
Remind one signer
remindSigner 2 params → 401200404409429
POST
/v1/signings/{signingId}/simulate
Drive a sandbox signing to an outcome
simulateSigning 1 param body → 401429200400403404409
Batches 2
POST
/v1/batches
Raise one signing per document for one set of parties
createBatch body → 401429201400402
GET
/v1/batches/{batchId}
Poll a batch and every signing in it
getBatch 1 param → 401429200404
Files 3
POST
/v1/files
Store a document once for reuse across signings
uploadFile body → 429201400401
GET
/v1/files/{fileToken}
Inspect a stored file
getFile 1 param → 401429200404
DELETE
/v1/files/{fileToken}
Purge a stored file
deleteFile 1 param → 401429200404

Schemas 14

The contract defines 14 schemas that model the data the API accepts and returns. The most detailed are Signing (15 properties), Signer (15 properties), CreateSigningRequest (10 properties), StoredFile (8 properties). Each schema is shown below with its type and property counts.

CreateSigningRequest
object
Exactly one of document (a finished file) or container (several files composed into a new one) is required.
10 properties 2 required
SignerRequest
object
6 properties 1 required
SigningList
object
3 properties 3 required
Signing
object
15 properties
Signer
object
15 properties
Batch
object
5 properties
StoredFile
object
8 properties
Comment
object
5 properties
SignedDocument
object
The newest signed output. Absent until somebody signs, except on a sandbox simulation, where it describes the unsigned artifact.
5 properties
SigningStatus
string
pending - at least one signer can still sign. completed - every signer signed. declined - somebody declined and nobody else can still sign. expired - the windo…
SignerStatus
string
waiting - a sequential signer whose turn has not come; their ceremony link answers 404 until it does. recorded - a viewer. Never invited, never blocks completi…
SigningMethod
string
The orchestration methods. For direct LT ATK reader, USB, raw CAdES and lower-level NFC integration, use the ATK API.
ProblemFieldError
object
One rejected field.
2 properties 2 required
Problem
object
RFC 9457.
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tvarka-sign-api-openapi.yml Raw ↑

Other APIs Tvarka ATK API publishes across the network.

Tvarka ATK API Auth API
Tvarka ATK API Erasure API
Tvarka ATK API LTV API
Tvarka ATK API Pairing API
Tvarka ATK API Sign API
Tvarka ATK API Tvarka ATK API API
Tvarka ATK API Tvarka ATK QES Signing API (paid Tier Addendum) API
Tvarka ATK API Validation API
Tvarka ATK API Well Known API
Where this information came from

This is an independent, third-party profile of Tvarka Sign API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.