---
title: "Get a Terms of Service agreement by id"
method: GET
path: "/terms_of_service/agreements/{agreement_id}"
tags: ["Terms of Service"]
---

# Get a Terms of Service agreement by id

`GET /terms_of_service/agreements/{agreement_id}`

Retrieve a single ToS agreement record. Returns `404` if the agreement does not exist or does not belong to the authenticated user.

## Path parameters

- `agreement_id` string, uuid, required

## Response `200`

Agreement.

- TosAgreementWrapped
  - `data` TosAgreement, required — A recorded user agreement to a product's Terms of Service. The `user_id` is intentionally NOT echoed back on this public surface - the caller already knows their own identity.
    - `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

## 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/revisions/8f5f4e537994/schema)