List legal documents

Returns every currently published legal document: the terms, the privacy policy, and any other document currently in force. It also reports whether the authenticated user still needs to accept them. needs_acceptance is true only when a document the user has never agreed to in any version is in force; a new version of a document they already accepted is announced by email and does not set the flag. Each entry carries a version-exact accepted flag, so needs_acceptance: false alongside accepted: false marks an update the user has been notified of but has not re-signed. Download each PDF from GET /me/terms/documents/{document_id}/file. Session auth only.

GEThttps://api.omnifence.ai/api/v1/me/terms

Returns every currently published legal document: the terms, the privacy policy, and any other document the operator requires. It also reports whether the authenticated user still needs to accept them.

needs_acceptance is true only when a document the user has never agreed to in any version is in force. When the operator publishes a new version of a document the user already accepted, they are notified by email and needs_acceptance stays false. The API does not ask them to sign again.

Each entry carries a version-exact accepted flag. An entry with accepted: false while needs_acceptance is false is an updated document the user has been notified about but has not re-signed. To record that signature, submit every document_id in the list to Accept legal documents. The API rejects a partial set, and documents already on file keep their original acceptance date. Download a document's PDF from Download a legal document.

Session auth only. This endpoint is not usable with an API key.

Request#

Headers#

Name	Type	Required	Description
`Authorization`	string	Yes	Your API key as a Bearer token: `Bearer YOUR_API_KEY`.

Responses#

200 OK#

Field	Type	Always present
`needs_acceptance`	boolean	Yes
`documents`	array of object	Yes
`documents[].document_id`	string	Yes
`documents[].document_key`	string	Yes
`documents[].version`	integer	Yes
`documents[].title`	string	Yes
`documents[].file_name`	string	Yes
`documents[].file_size_bytes`	integer	Yes
`documents[].content_hash`	string	Yes
`documents[].published_at`	null or string (date-time)	No
`documents[].accepted`	boolean	Yes

Example responseJSON

{
  "needs_acceptance": false,
  "documents": [
    {
      "document_id": "string",
      "document_key": "string",
      "version": 0,
      "title": "string",
      "file_name": "string",
      "file_size_bytes": 0,
      "content_hash": "string",
      "published_at": "2026-05-19T12:00:00.000Z",
      "accepted": false
    }
  ]
}