Skip to main content
GET
/
documents
List documents
curl --request GET \
  --url https://api.clearpolicy.app/api/v1/documents \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "organization_id": "<string>",
      "name": "<string>",
      "has_published_revision": true,
      "attestation_counts": {
        "attested_latest": 123,
        "pending_attested": 123,
        "attested_outdated": 123,
        "unrequested": 123,
        "renewal_due": 123,
        "total": 123
      },
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "renewal_interval_days": 123,
      "auto_renew": true,
      "archived_at": "2023-11-07T05:31:56Z",
      "last_updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "links": {
    "first": "<string>",
    "last": "<string>",
    "prev": "<string>",
    "next": "<string>"
  },
  "meta": {
    "current_page": 123,
    "from": 123,
    "last_page": 123,
    "per_page": 123,
    "to": 123,
    "total": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.clearpolicy.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

OAuth 2.0 bearer token obtained via the client credentials flow with the api:use scope.

Query Parameters

name
string

Filter by document name (case-insensitive partial match).

Maximum string length: 255
archived
enum<string>
default:false

When true or 1, returns only archived documents. When omitted or false, returns only active documents.

Available options:
true,
false,
1,
0
per_page
integer
default:25

Number of results per page (1–100).

Required range: 1 <= x <= 100
page
integer
default:1

Page number to retrieve.

Required range: x >= 1

Response

A paginated list of documents.

data
object[]
meta
object
Last modified on May 27, 2026