Retention Policy

---

Read the GoBD retention rule the archive applies to this company. The rule is fixed by German law and cannot be changed through the API.

GoBD archive availability

These endpoints are available only for companies archived under the German GoBD rules.

Endpoint

Property	Value
URL	GET /germany/archive/{companyId}/retention-policy
Method	GET
Auth	R-Auth: <company-jwt>
Base URL	Stage Environment https://api-stage.docnova.ai/ Production Environment https://api.docnova.ai/

Example Request

curl --location '{{baseUrl}}/germany/archive/{{companyId}}/retention-policy' \
--header 'R-Auth: {{companyJwt}}'

Path parameters

Parameter	Type	Required	Description
companyId	UUID	Yes	Company UUID

Response

{
  "retentionYears": 8,
  "rule": "8 Jahre ab Ende des Kalenderjahres der Rechnungsausstellung bzw. des Zugangs, wenn dieses später liegt; Ende am 31.12. des Jahres (Ausstellungs- bzw. Zugangsjahr + 8). Eine gesetzliche Aufbewahrungssperre (Legal Hold) verlängert die Aufbewahrung.",
  "legalBasis": "§ 147 Abs. 1 Nr. 4, Abs. 3 AO; § 14b UStG; GoBD",
  "changeable": false
}

Response fields

Field	Description
retentionYears	Statutory retention period in years, currently 8
rule	Human-readable rule text (German), as shown to the company
legalBasis	Statutory references the rule is based on
changeable	Always false — the rule cannot be edited through the API

Error responses

HTTP	errorType	Meaning
400	GERMANY_ARCHIVE_NOT_AVAILABLE	The company is not archived under the German GoBD rules
403	GERMANY_AUDITOR_ACCESS_EXPIRED	Caller's time-limited auditor access (Z1) has ended

See also the general Error Reference for standard authentication and authorization errors shared by every partner endpoint.

Auditor access (Z1)

A time-limited auditor granted direct access to a company (§ 147 Abs. 6 AO) uses the same endpoints as any other company user; access ends automatically at the configured limit, even before the auditor's company membership is removed.