Tvarka Proof API

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.

Create your first proof

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"}'

Web capture collections

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.

Timestamps and web page capture

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.

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.

Related pages

Questions: info@tvarka.pro