---
title: "List the calling user's Terms of Service agreements"
method: GET
path: "/terms_of_service/agreements"
tags: ["Terms of Service"]
---

# List the calling user's Terms of Service agreements

`GET /terms_of_service/agreements`

Returns the Terms of Service agreements the authenticated user has on file. Each entry records the version agreed to and when. Most users only have one agreement per product, but if the ToS is updated and the user re-agrees a new entry is added.

Results are paginated with the standard `page[number]` / `page[size]` parameters; the response uses the standard `{data, meta}` JSON:API envelope.

By default this returns agreements for **all** products the user has agreed to. Pass the `product_type` query parameter to scope the result to a single product.

## Query parameters

- `product_type` 'branded_calling' | 'number_reputation' — Telnyx product the Terms of Service apply to.
- `page[number]` integer
- `page[size]` integer

## Response `200`

Paginated list of agreements.

- TosAgreementList — Paginated list of Terms of Service agreements for the calling user.
  - `data` TosAgreement[], required
    - `id` string, uuid
    - `terms_version` string
    - `version` string — Convenience alias of `terms_version`. Both keys are present on every response.
    - `product_type` 'branded_calling' | 'number_reputation' — Telnyx product the Terms of Service apply to.
    - `agreed_at` string, date-time
    - `created_at` string, date-time
  - `meta` BrandedCallingPaginationMeta, required — JSON:API pagination metadata returned with every paginated list response. Page numbering is 1-based. `page_size` reports the number of items actually returned in `data` for this page; the requested size is taken from the `page[size]` query parameter.
    - `total_pages` integer, required — Total number of pages available given the current `page_size`.
    - `total_results` integer, required — Total number of items across all pages (excludes soft-deleted rows).
    - `page_number` integer, required — 1-based index of this page. Echoes the `page[number]` query parameter (default `1`).
    - `page_size` integer, required — Number of items returned in this page's `data` array. Capped at 250.

## Other responses

- `default` — An error occurred. The response carries the standard Telnyx error envelope.
- `4XX` — An error occurred. The response carries the standard Telnyx error envelope.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)