---
title: "Preview Subscription Documents"
method: POST
path: "/admin/subscriptions/preview-subscription-documents"
tags: ["admin", "subscriptions"]
---

# Preview Subscription Documents

`POST /admin/subscriptions/preview-subscription-documents`

## Request

- Base URL: `https://api.trytrata.com`
- URL: `https://api.trytrata.com/admin/subscriptions/preview-subscription-documents`
- Auth: HTTP bearer

## Request body

- GenerateSubscriptionAgreementDocumentsRequest
  - `organization_id` string, uuid, required
  - `effective_date` string, date-time, required
  - `subscription_terms` AdminSubscriptionTermsInput, required
    - `seat_limit` integer, required
    - `price_per_year_cents` integer, required
    - `length_days` integer, nullable
    - `recurring` boolean
    - `credit_balance_cents` integer, nullable
    - `credit_calls_requirement` integer, nullable
    - `credit_calls_level` 'Organization' | 'User'
    - `credit_calls_deadline_days` integer, nullable
    - `credit_calls_deadline` string, date-time, nullable
    - `trata_pays_user_amount_cents` integer, nullable
    - `trata_pays_user_per_n_calls` integer, nullable
    - `trata_pays_user_max_calls` integer, nullable
    - `user_pays_trata_amount_cents` integer, nullable
    - `auto_finalize_invoice` boolean
    - `invoice_days_until_due` integer, nullable
  - `subscription_term_id` string, uuid, nullable

## Response `200`

Successful Response

- SubscriptionAgreementDocumentsResponse
  - `subscription_agreement_pdf_bytes` string, nullable, required
  - `r_and_d_pdf_bytes` string, nullable

## Other responses

- `404`: Not found
- `422`: Validation Error

## Changes

- **2026-10-21** `abbad754918f`: 1 warning
  - the `subscription_terms/length_days/anyOf[subschema #1]/` request property's max was set to `1095.00`
- **2026-09-16** `7d4d864e0649`: 2 info
  - added the new optional request property `subscription_terms/auto_finalize_invoice`
  - added the new optional request property `subscription_terms/invoice_days_until_due`
- **2026-09-15** `5c438a0a1e9f`: 1 info
  - added the new optional request property `subscription_terms/credit_calls_level`

[Operation history](https://skmtc.dev/trytrata/apis/trytrata-api/changes/admin/subscriptions/preview-subscription-documents/post.md)

---

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