Get one version of a document

GET

/v1/documents/{slug}/versions/{version}

const url = 'https://api.adversarial.com/api/v1/documents/cisp/versions/2024.4.1';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.adversarial.com/api/v1/documents/cisp/versions/2024.4.1

Renders any version the organization can see — its current version, or a retired version it previously used. The representation is content negotiated: a request whose Accept header includes the docx media type receives the rendered docx as an attachment; anything else receives the document flattened into read-only markdown as JSON.

Parameters

Path Parameters

slug

required

string

The document slug

Example

cisp

version

required

string

The document version

Example

2024.4.1

Responses

200

The requested document version, as JSON or docx per the Accept header

One version rendered as flattened markdown with the organization’s selections applied, including edits pending approval. For the approved-only policy of record, use the MCP get_compliance_document tool.

object

markdown

required

string

slug

required

string

title

required

string

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

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

{
  "slug": "cisp",
  "version": "2026.9.1",
  "version_state": "current"
}

404

The organization cannot see this document version