---
title: "List document's conditions"
method: GET
path: "/documents/{document}/conditions"
tags: ["Document Operations"]
---

# List document's conditions

`GET /documents/{document}/conditions`

## Request

- Base URL: `https://app.fynk.com/v1/api`
- URL: `https://app.fynk.com/v1/api/documents/{document}/conditions`
- Auth: HTTP bearer

<small>Requires an API token with the **Document Reader** role.</small>

Lists a [document's](/#documents) [conditions](/#conditions) and tells you which of them currently apply.

A condition's `is_active` value is derived from the document's [dynamic field](/#dynamic-fields) values, so
updating a field via the [update dynamic field](/operations/v1.documents.dynamic-fields.update) endpoint may
change which conditions are active.

## Path parameters

- `document` string, required

## Response `200`

Array of `ConditionResource`

- object
  - `data` ConditionResource[], required
    - `uuid` string, required
    - `name` string, required: The name given to the condition in the fynk editor
    - `is_active` boolean, required: True if the condition currently evaluates to true, i.e. the content it guards is part of the document as it stands now

## Other responses

- `401`: Unauthenticated
- `403`: Authorization error
- `404`: Not found

## Changes

- **2026-09-25** `b152da28f721`: 1 info
  - added the optional property `error_type` to the response with the `403` status
- **2026-09-02** `102188b5a7e6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fynk/apis/fynk-api-reference/changes/documents/:document/conditions/get.md)

---

[API](https://skmtc.dev/fynk/apis/fynk-api-reference.md) - [All operations](https://skmtc.dev/fynk/apis/fynk-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/fynk/apis/fynk-api-reference/revisions/121033338e69?raw)