---
title: "List Subscription Terms"
method: GET
path: "/admin/organizations/{organization_id}/subscription-terms"
tags: ["admin", "organizations"]
---

# List Subscription Terms

`GET /admin/organizations/{organization_id}/subscription-terms`

## Request

- Base URL: `https://api.trytrata.com`
- URL: `https://api.trytrata.com/admin/organizations/{organization_id}/subscription-terms`
- Auth: HTTP bearer

## Path parameters

- `organization_id` string, uuid, required

## Response `200`

Successful Response

- SubscriptionTermsOverview
  - `terms` SubscriptionTermsRow[]
    - `term_id` string, uuid, required
    - `organization_id` string, uuid, required
    - `organization_name` string, required
    - `representative_user_id` string, nullable
    - `representative_name` string, nullable
    - `is_current` boolean, required
    - `effective_at` string, date-time, required
    - `expires_at` string, date-time, nullable
    - `terms` SubscriptionTerms, required
      - `seat_limit` integer, required
      - `length_days` integer
      - `price_per_year_cents` integer, required
      - `additional_seat_fee_cents` 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
      - `trata_pays_user_refresh_weeks` integer, nullable
      - `user_pays_trata_amount_cents` integer, nullable
      - `auto_finalize_invoice` boolean
      - `invoice_days_until_due` integer, nullable
      - `custom_subscription_template_s3_key` string, nullable
      - `custom_r_and_d_template_s3_key` string, nullable
    - `subscription` OrganizationSubscriptionRecord
      - `id` string, uuid, required
      - `stripe_subscription_id` string, required
      - `stripe_customer_id` string, required
      - `status` 'INCOMPLETE' | 'INCOMPLETE_EXPIRED' | 'TRIALING' | 'ACTIVE' | 'ACTIVE_PAST_DUE' | 'PAST_DUE' | 'CANCELED' | 'UNPAID' | 'PAUSED', required
      - `seat_limit` integer, required
      - `created_at` string, date-time, required
    - `signed_contracts` SignedContract[]
      - `agreement_document_id` string, uuid, required
      - `agreement_document_slug` string, required
      - `signed` boolean
      - `signatures` ContractSignature[]
        - `agreement_signature_id` string, uuid, required
        - `signer_user_id` string, required
        - `signer_name` string, nullable
        - `signed_at` string, date-time, required
  - `subscription_history` OrganizationSubscriptionRecord[]
    - `id` string, uuid, required
    - `stripe_subscription_id` string, required
    - `stripe_customer_id` string, required
    - `status` 'INCOMPLETE' | 'INCOMPLETE_EXPIRED' | 'TRIALING' | 'ACTIVE' | 'ACTIVE_PAST_DUE' | 'PAST_DUE' | 'CANCELED' | 'UNPAID' | 'PAUSED', required
    - `seat_limit` integer, required
    - `created_at` string, date-time, required

## Other responses

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

## Changes

- **2026-09-17** `2460b5597a62`: 2 warning
  - added the new `ACTIVE_PAST_DUE` enum value to the `subscription_history/items/status` response property for the response status `200`
  - added the new `ACTIVE_PAST_DUE` enum value to the `terms/items/subscription/anyOf[subschema #1: OrganizationSubscriptionRecord]/status` response property for the response status `200`
- **2026-09-16** `7d4d864e0649`: 2 info
  - added the optional property `terms/items/terms/auto_finalize_invoice` to the response with the `200` status
  - added the optional property `terms/items/terms/invoice_days_until_due` to the response with the `200` status
- **2026-09-15** `5c438a0a1e9f`: 1 info
  - added the optional property `terms/items/terms/credit_calls_level` to the response with the `200` status

[Operation history](https://skmtc.dev/trytrata/apis/trytrata-api/changes/admin/organizations/:organization_id/subscription-terms/get.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)