# List legal terms

`GET https://api.cademi.com.br/api/v3/legal-terms`

Operation ID: `legal_terms.list` · API v3

Lists the configured legal terms: at most one for the platform and one per product. The collection can be filtered by scope and product.

The term body is not included in the collection; use the retrieve operation to obtain it. When the credentials are restricted to specific legal terms, only those terms are returned.

Returns all matching legal terms in a single response while preserving the standard collection response format.

Required permissions: `legal_terms.read`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `scope` | query | string, one of `platform`, `product` | no |  |
| `product_id` | query | string | no |  |

## Responses

### 200

Returns the collection of legal terms.

Body: `data`: array of LegalTerm.

Fields of LegalTerm:

| Field | Type | Required | Description |
|---|---|---|---|
| `acceptances_count` | integer | yes |  |
| `body` | object | no | Content of the legal terms as an Editor.js document. Returned only when retrieving a single legal term. |
| `id` | string | yes | Public ID derived from the scope: trmplatform, or trmproduct_<n>, where <n> is the numeric part of the product's public ID. |
| `object` | string, one of `legal_term` | yes |  |
| `product_id` | string or null | yes | Public ID of the product, prefixed with prd_. null for the platform scope. |
| `revision` | string | yes |  |
| `scope` | string, one of `platform`, `product` | yes |  |
| `title` | string | yes | Derived from the scope: the account name for the platform scope, or the product name for the product scope. |
| `updated_at` | string (date-time) | yes |  |

### 400

The request contains an unsupported query parameter.

Body: Error.

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

### 422

The request body or query parameters failed validation.

Body: ValidationFailed.

Full schema: https://cademi.dev/openapi/v3.json