> ## Documentation Index
> Fetch the complete documentation index at: https://docs.turrisfi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Contract Container Templates

> Retrieve active ContractContainer templates for your organization

Returns active ContractContainer templates available to your organization. Each item describes one template, including its underlying producer-agreement PDF and any additional folder documents.

## Which ID do I send on invite?

Each template carries three different IDs. Use the **top-level `_id`** as `contractContainerTemplateId` when calling [Invite Downstream Entity](/api-reference/v1/downstream-entity-associations/invite).

| Field in response                      | What it identifies                             | When to use it                                                                                                  |
| -------------------------------------- | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `_id` (top-level)                      | The ContractContainer template itself          | `contractContainerTemplateId` on the [invite endpoint](/api-reference/v1/downstream-entity-associations/invite) |
| `producerAgreement.fileDocumentId`     | The PDF behind the producer-agreement document | Downloading the PDF via [List File Documents](/api-reference/v1/file-documents/list-documents)                  |
| `additionalDocuments[].fileDocumentId` | A PDF inside the template's folder set         | Downloading that document via [List File Documents](/api-reference/v1/file-documents/list-documents)            |

<Note>
  `_id` is the only value the [invite endpoint](/api-reference/v1/downstream-entity-associations/invite) accepts as `contractContainerTemplateId`. Sending one of the `fileDocumentId` values instead will return `400 No active contract template found for that contractContainerTemplateId`.
</Note>

### Example

Given a response item like:

```json theme={null}
{
  "_id": "6a0dee5f72ffa31272c65a6c",
  "name": "Producer Agreement",
  "status": "active",
  "producerAgreement": {
    "fileDocumentId": "6847fed985e35f21c00bfd79",
    "customFields": []
  },
  "additionalDocuments": [
    { "fileDocumentId": "6a0e01d5d4227d43c85af4cd", "name": "Compensation & Commission Schedules" }
  ]
}
```

The invite call uses the top-level `_id`:

```json theme={null}
POST /v1/downstream-entity-associations/invite
{
  "contractContainerTemplateId": "6a0dee5f72ffa31272c65a6c",
  ...
}
```


## OpenAPI

````yaml openapi/v1.json GET /v1/contract-container-templates
openapi: 3.0.0
info:
  title: Turris Public API
  description: API for managing insurance compliance data
  version: 1.0.0
  contact: {}
servers:
  - url: https://public.api.live.turrisfi.com
    description: Production
  - url: https://public.api.sandbox.turrisfi.com
    description: Sandbox
security: []
tags: []
paths:
  /v1/contract-container-templates:
    get:
      tags:
        - contract-container-templates
      operationId: ContractContainerTemplatesController_getContractContainerTemplates_v1
      parameters: []
      responses:
        '200':
          description: >-
            Active ContractContainer templates for your organization. Use the
            returned _id as contractContainerTemplateId on POST
            /v1/downstream-entity-associations/invite.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: >-
                        #/components/schemas/ContractContainerTemplateResponseDto
                  requestId:
                    type: string
                    description: Unique request identifier
                    example: dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8
                  timestamp:
                    type: string
                    description: Response timestamp
                    example: '2025-11-12T20:49:03.293Z'
                required:
                  - data
                  - requestId
                  - timestamp
        '401':
          description: Invalid or missing auth token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
components:
  schemas:
    ContractContainerTemplateResponseDto:
      type: object
      properties:
        _id:
          type: string
          description: Unique ContractContainer template ID
          example: 507f1f77bcf86cd799439011
        name:
          type: string
          description: Human-readable name of the contract template
          example: Standard Producer Agreement
        status:
          type: string
          description: Lifecycle status of the contract template
          enum:
            - submitted
            - processing
            - active
            - archived
          example: active
        producerAgreement:
          description: Producer agreement portion of the template
          allOf:
            - $ref: >-
                #/components/schemas/ContractContainerTemplateProducerAgreementResponseDto
        additionalDocuments:
          description: >-
            Additional documents bundled with the template (folders flattened
            into a single list)
          type: array
          items:
            $ref: >-
              #/components/schemas/ContractContainerTemplateAdditionalDocumentResponseDto
        createdAt:
          format: date-time
          type: string
          description: Creation timestamp
        updatedAt:
          format: date-time
          type: string
          description: Last update timestamp
      required:
        - _id
        - name
        - status
        - producerAgreement
        - createdAt
        - updatedAt
    ErrorResponseDto:
      type: object
      properties:
        statusCode:
          type: number
          description: HTTP status code
        requestId:
          type: string
          description: Unique request identifier for debugging
        errorType:
          type: string
          description: Error type classification
        errorMessage:
          description: Array of error messages
          type: array
          items:
            type: string
        timestamp:
          type: string
          description: ISO timestamp when the error occurred
        details:
          type: object
          description: Additional error context
      required:
        - statusCode
        - requestId
        - errorType
        - errorMessage
        - timestamp
    ContractContainerTemplateProducerAgreementResponseDto:
      type: object
      properties:
        fileDocumentId:
          type: string
          description: File document ID of the producer agreement PDF
          example: 507f1f77bcf86cd799439011
        customFields:
          description: Custom-field definitions baked into the producer agreement template
          type: array
          items:
            $ref: >-
              #/components/schemas/ContractContainerTemplateCustomFieldResponseDto
      required:
        - fileDocumentId
        - customFields
    ContractContainerTemplateAdditionalDocumentResponseDto:
      type: object
      properties:
        fileDocumentId:
          type: string
          description: File document ID of the additional document
          example: 507f1f77bcf86cd799439012
        name:
          type: string
          description: Display name of the additional document
          example: W-9 Tax Form
      required:
        - fileDocumentId
        - name
    ContractContainerTemplateCustomFieldResponseDto:
      type: object
      properties:
        fieldName:
          type: string
          description: Field name
          example: commissionNumber
        fieldType:
          type: string
          description: Field type
          enum:
            - string
            - number
          example: string
        value:
          type: string
          description: Current value (if set on the template)
        defaultValue:
          type: string
          description: Default value applied when none is provided
        isRequired:
          type: boolean
          description: Whether the field must be provided
          example: true
        minValue:
          type: number
          description: Inclusive minimum value (numeric fields only)
        maxValue:
          type: number
          description: Inclusive maximum value (numeric fields only)
      required:
        - fieldName
        - fieldType

````