# Get engagement documents by engagement ID

**Retrieve documents associated with a specific engagement**
Returns all engagement documents linked to the given engagement ID, including
the document type name for each record.
**Real Example:**

```bash
curl --location 'https://{{host}}/v1/engagement_documents/by_engagement/34567' \
--header 'Authorization: bearer {{token}}'
```

Endpoint: GET /gql/v1/engagement_documents/by_engagement/{engagementId}
Version: 1.0.0
Security: BearerAuth

## Path parameters:

  - `engagementId` (integer, required)
    Unique identifier of the engagement

## Response 200 fields (application/json):

  - `engagementDocuments` (array)

  - `engagementDocuments.id` (integer)
    Unique engagement document identifier
    Example: 101

  - `engagementDocuments.fileId` (integer)
    Associated file identifier
    Example: 5001

  - `engagementDocuments.engagementId` (integer)
    Associated engagement identifier
    Example: 34567

  - `engagementDocuments.engagementDocumentTypeId` (integer)
    Document type identifier
    Example: 2

  - `engagementDocuments.is_active` (boolean)
    Whether this document record is active
    Example: true

  - `engagementDocuments.clientFacing` (boolean)
    Whether the document is visible to the client
    Example: true

  - `engagementDocuments.blocksExecution` (boolean)
    Whether this document must be signed before the engagement executes
    Example: true

  - `engagementDocuments.signatureRequirementType` (string)
    Signature requirement mode
    Enum: "ALL_SIGNATURES_REQUIRED", "ONE_SIGNATURE_REQUIRED"

  - `engagementDocuments.createdAt` (string)
    Record creation timestamp
    Example: 2024-01-15T10:00:00Z

  - `engagementDocuments.updatedAt` (string)
    Record last updated timestamp
    Example: 2024-03-20T14:30:00Z

  - `engagementDocuments.affirmativeStatus` (string)
    Consent acceptance status of the document. NEGATIVE = one or more negative responses AFFIRMATIVE = all signers responded positively INDETERMINATE = at least one positive response but not all signers have responded yet
    Enum: "NEGATIVE", "AFFIRMATIVE", "INDETERMINATE"

  - `engagementDocuments.documentType` (object)
    The document type associated with this record

  - `engagementDocuments.documentType.id` (integer)
    Document type identifier
    Example: 2

  - `engagementDocuments.documentType.name` (string)
    Document type name
    Example: Consent Document