Get the version of a document the organization is currently on

GET

/v1/documents/{slug}

const url = 'https://api.adversarial.com/api/v1/documents/cybergov';
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/cybergov

Resolves a slug to the organization’s policy of record, so a client holding only a slug can address the version routes without fetching the whole list.

Parameters

Path Parameters

slug

required

string

The document slug

Example

cybergov

Responses

200

How the organization stands on this document

application/json

How an organization stands on one document: the version in force, and the version it is adopting, if any. The body of GET/PATCH /documents/{slug}.

object

adopting_version

One of:

string
null

The version the organization holds but has not promoted. Approving its proposal is what makes it current.

string

current

One of:

object
null

The version currently in force — the organization’s policy of record. For an uninitialized document this is the template it would initialize to; None while an adoption started from that state is in flight, because the draft is then the only version the organization holds.

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.MM.NN: the year and month it was issued, then a two-digit sequence number counting editions issued in that month.

string

slug

required

string

state

One of:

object
null

One of:

The document has not been initialized yet. It is possible for the document to have details, meaning that a proposal is “open” to initialize it.

object

value

required

string

Allowed values: uninitialized

The initial proposal is being opened

object

details

required

The initial proposal is being opened

object

last_approved_action

One of:

object
null

Who performed an action, and when.

object

One of:

string
null

string format: uuid

date

required

string format: date-time

last_modified_action

One of:

object
null

Who performed an action, and when.

object

One of:

string
null

string format: uuid

date

required

string format: date-time

status

required

One of:

object
object

There are no open changes to the document

object

changes

required

string

Allowed values: no_changes

version

required

The edition of a document as YYYY.MM.NN: the year and month it was issued, then a two-digit sequence number counting editions issued in that month.

string

value

required

string

Allowed values: pending_initialization

The document has been initialized and is ready for use

object

details

required

The document has been initialized and is ready for use

object

last_approved_action

One of:

object
null

Who performed an action, and when.

object

One of:

string
null

string format: uuid

date

required

string format: date-time

last_modified_action

One of:

object
null

Who performed an action, and when.

object

One of:

string
null

string format: uuid

date

required

string format: date-time

status

required

One of:

object
object

There are no open changes to the document

object

changes

required

string

Allowed values: no_changes

version

required

The edition of a document as YYYY.MM.NN: the year and month it was issued, then a two-digit sequence number counting editions issued in that month.

string

value

required

string

Allowed values: initialized

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

{
  "adopting_version": "2026.09.01",
  "current": {
    "category": "governance",
    "latest_version": "2026.09.01",
    "slug": "cisp",
    "state": {
      "value": "uninitialized"
    },
    "version": "2026.09.01",
    "version_state": "current"
  }
}

404

No such document