Developers
Deliver legal content where it's needed.
Published content is available via the Public Delivery API as JSON or sanitized HTML fragments. App API access is available as a separate feature from the Business plan onward.
Public Delivery API
Read-only. Fast. Cache-friendly.
The Public Delivery API serves only already-published content. Write operations and unpublished drafts are not reachable through this interface.
Fetch JSON
Structured format with sections, blocks, and metadata.
Embed HTML fragment
Sanitized HTML fragments for direct embedding in existing pages.
Use ETag
Cache-friendly responses with ETag and matching headers.
Pin a version
Request and lock specific versions deliberately.
Example
Fetch the published privacy document.
Simplified example calls — not a live backend integration.
GET https://api.termshelf.de/v1/documents/datenschutz
?site=acme-de
&locale=de
&version=4.2.0
Headers:
Accept: application/json
If-None-Match: W/"a1f2c-v4.2.0"
200 OK
ETag: W/"a1f2c-v4.2.0"
Cache-Control: public, max-age=300
{
"document": "datenschutz",
"version": "4.2.0",
"locale": "de",
"site": "acme-de",
"sections": [ /* … */ ]
}GET https://api.termshelf.de/v1/documents/datenschutz/html
?site=acme-de
&locale=de
Headers:
Accept: text/html
200 OK
ETag: W/"a1f2c-v4.2.0"
Cache-Control: public, max-age=300
<section data-doc="datenschutz" data-version="4.2.0">
<h2>Verantwortlicher</h2>
<p>…</p>
</section>App API access
A separate interface, available from Business.
App API access exposes functionality for workspaces, documents, and operational flows. It's clearly separated from the Public Delivery API and available from the Business plan onward.
- Management of workspaces, sites, and locales
- Documents, versions, and reviews
- Publications and targets
- Scanner jobs and findings
- Token-based authentication
Auth
Token-based authentication scoped to a workspace.
Webhooks
Signed, replayable delivery of publication events.
Publish, deliver, integrate.
TermShelf brings the Public Delivery API and app functions into a clear framework.