Version 1.30.0
A fact is fixed at a moment in time. A file is sealed with a qualified timestamp. A web page is captured as it looked. Every proof carries a code and a link that anyone can check.
One POST to /v1/timestamps returns a sealed proof with a PDF certificate and a check link. The file can stay with you, because its fingerprint (hash) is enough. Each proof is paid from the balance.
BASE=https://sign-api.tvarka.pro
# TVARKA_KEY holds your API key.
HASH=$(openssl dgst -sha256 -binary contract.pdf | base64)
curl -sS "$BASE/v1/timestamps" \
-H "Authorization: Bearer $TVARKA_KEY" -H 'Content-Type: application/json' \
-d "{\"hash\": {\"algorithm\": \"sha256\", \"value\": \"$HASH\"}}"
curl -sS "$BASE/v1/timestamps" \
-H "Authorization: Bearer $TVARKA_KEY" -H 'Content-Type: application/json' \
-d '{"page": {"url": "https://example.com/offer"}, "title": "Offer page"}'
POST /v1/capture-monitors: give page.url,
everyHours (default 24), maxCaptures (default 30),
and optionally endsAt. The first capture starts now.
Pause or resume with PATCH /v1/capture-monitors/{monitorId}
and status: paused or active. Queued work continues;
missed intervals are skipped. Each completed capture has its normal price.
POST /v1/capture-bundles: give urls (1–20 distinct
addresses), optional shared page settings and externalId
for the matter. Read its state, then download /v1/capture-bundles/{bundleId}/file.
The ZIP includes a qualified timestamped manifest, an exhibit index, certificates
and archives. Failed URLs remain listed. Bundle assembly adds no fee.
Every capture reports page.quality, separate from job completion.
Challenge pages, login forms, partial captures and missing artifacts are explicit.
Quality findings are observations, not a guarantee of complete collection.
Use monitorId or bundleId to filter
GET /v1/timestamps. Corresponding MCP tools are listed under MCP server.
POST /v1/timestamps takes exactly one of document,
hash or page (v1.22.0). Each result has its own
reference code and a public check page in verifyUrl.
document: one of content (base64, up to 15 MiB),
fileToken from POST /v1/files, url (public
HTTPS), markdown (rendered to an A4 PDF) or documentId
(a vault document). A PDF comes back as the same PDF with a document timestamp
(output: pdf). Any other file comes back in an ASiC-S container
(output: asics). Answers 201.hash: {"algorithm": "sha256", "value": "<base64>"}
for a file you keep. The token comes back in token and as the file
(output: token). Answers 201.page: a public HTTPS address. The page is opened in a browser,
captured as a full-page screenshot with its HTML, and sealed in a certificate
PDF under one qualified timestamp. Answers 202 with
status: pending. Poll GET /v1/timestamps/{timestampId}
until completed or failed, or set
webhookUrl for timestamp.completed and
timestamp.failed.The place of capture. page.location opens the
page through a home internet connection in a chosen place (v1.24.0):
country (ISO code, such as DE), and optionally a
state or a city, and a zip. The exit
address and its place are recorded in page.exit and in the
certificate. When no exit in that country can be confirmed, the capture fails
with location_unavailable and is not charged.
page.locations compares 2 to 5 places in one certificate (v1.25.0).
page.device (desktop or mobile),
page.locale, page.consent: reject (the cookie test)
and page.recheckAt (a recapture with what changed) are optional.
secondTimestamp: true adds a second qualified timestamp from
another authority. language sets the certificate language.
{"page": {"url": "https://example.com/offer", "location": {"country": "DE", "city": "Berlin"}},
"title": "Offer page", "externalId": "case-118"}
Qualified or simple. Every timestamp is qualified by
default. Send "qualified": false for a document or a hash to take
a simple timestamp (v1.23.0). A web page capture is always qualified.
GET /v1/timestamps lists the latest ones, filtered by
source, monitorId or bundleId.
GET /v1/timestamps/{timestampId}/file returns the PDF, the
ASiC-S container or the token. MCP: timestamp_document,
certify_webpage and get_timestamp.
Prices, one charge per completed timestamp, excluding VAT:
qualified timestamp or web page capture EUR 0.19, simple timestamp
EUR 0.13, a capture from a chosen place EUR 0.49 per place,
the cookie test EUR 0.99. A failed capture is not charged.
503 timestamp-unavailable means no authority answered and nothing
was charged. Retry it.
Questions: info@tvarka.pro