Skip to content

List documents

GET
/v1/documents
curl --request GET \
--url 'https://api.adversarial.com/api/v1/documents?version=2024.4.1'

Returns one row per (slug, version) the organization can see: its current documents, a version held for adoption, and any retired versions it previously used. Workflow state is absent only on retired rows.

version
string | null

Only return rows for this version.

Example
2024.4.1
state
One of:
null

Only return current or archived rows.

List all documents

Media typeapplication/json

A list of compliance documents with their current status.

Array<object>

Provides basic information about one version of a document. The document list contains one row per (slug, version) the organization can see.

object
archived_date

When the organization retired this version. Only set on archived rows.

string | null format: date-time
category
required

The compliance-program section containing a document.

string
Allowed values: governance procedure policy
description
required
string
latest_version
required

The edition of a document as YYYY.M.N: the year and month it was issued, then a sequence number counting editions issued in that month. Components carry no leading zeros.

string
slug
required
string
state
One of:
null
title
required
string
version
required

The version this row describes.

string
version_state
required

Whether a document version is the organization’s current one, a retired one it previously used, or an in-flight adoption draft.

string
Allowed values: current archived draft
Example
[
{
"category": "governance",
"latest_version": "2026.9.1",
"slug": "cisp",
"state": {
"value": "uninitialized"
},
"version": "2026.9.1",
"version_state": "current"
}
]