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

# Get the calling user's Terms of Service status

`GET /terms_of_service/status`

Returns whether the authenticated user has agreed to the current Terms of Service for the product given by `product_type`. Used during onboarding to decide whether to prompt the user with the ToS dialog before continuing.

`agreement_required: true` means the user has not yet agreed (or has agreed to an outdated version) and must agree before using that product's endpoints.

## Query parameters

- `product_type` 'branded_calling' | 'number_reputation' — Telnyx product the Terms of Service apply to.

## Response `200`

Status.

- TosStatusWrapped
  - `data` TosStatus, required — Whether the calling user has agreed to a product's current Terms of Service. The `user_id` is intentionally omitted on this public surface.
    - `agreed_at` string, date-time, nullable
    - `agreed_version` string, nullable — Version the user previously agreed to (may be older than `current_terms_version`). `null` if the user has never agreed.
    - `agreement_required` boolean, required — `true` when the user must agree to the latest version before using the product. Equivalent to `!has_agreed`.
    - `current_terms_version` string, required — Latest published version of the ToS for this product.
    - `has_agreed` boolean, required — `true` if the user has agreed to the latest version.
    - `product_type` 'branded_calling' | 'number_reputation', required — Telnyx product the Terms of Service apply to.

## Other responses

- `4XX` — An error occurred. The response carries the standard Telnyx error envelope.
- `default` — 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/revisions/3fdc16374d70/schema)