# Telnyx Calling: Trusted Calling — Documentation Index > Trusted Calling documentation within the Calling section of the Telnyx developer docs (https://developers.telnyx.com). > Root index: https://developers.telnyx.com/llms.txt · Calling index: https://telnyx-openapi-ng.s3.us-east-1.amazonaws.com/llms/calling.txt · Full content for this subsection: https://telnyx-openapi-ng.s3.us-east-1.amazonaws.com/llms/calling/trusted-calling-full.txt - [Overview](https://developers.telnyx.com/docs/branded-calling/overview.md): Display your business name, logo, and call reason on recipients' phone screens with Branded Calling. - [Quickstart](https://developers.telnyx.com/docs/branded-calling/quickstart.md): Get your first branded call working, from Terms of Service to a verified DIR with phone numbers attached. - [Overview](https://developers.telnyx.com/docs/branded-calling/enterprises.md): Register your business as an enterprise to use Branded Calling. - [Overview](https://developers.telnyx.com/docs/branded-calling/brands.md): Create and manage Display Identity Records (DIRs), the display identity shown to call recipients. - [Overview](https://developers.telnyx.com/docs/branded-calling/bc-phone-numbers.md): Attach phone numbers to a verified DIR and inspect the carrier-network vetting batches. - [Overview](https://developers.telnyx.com/docs/branded-calling/call-reasons.md): Configure the call reason text displayed to recipients, explaining why your business is calling. - [Overview](https://developers.telnyx.com/docs/branded-calling/terms-of-service.md): Accept the Branded Calling Terms of Service before activating Branded Calling on an enterprise. - [Overview](https://developers.telnyx.com/docs/branded-calling/infringement-claims.md): Inspect, contest, and resolve infringement claims filed against your DIR. ## API Reference (Trusted Calling) ### Enterprises - [List enterprises](https://developers.telnyx.com/api-reference/enterprises/list-enterprises.md): Return the enterprises you own, paginated. The default page size is 20; the maximum is 250. - [Create an enterprise](https://developers.telnyx.com/api-reference/enterprises/create-an-enterprise.md): Create the legal entity (enterprise) that represents your business on the Telnyx platform. - [Get an enterprise](https://developers.telnyx.com/api-reference/enterprises/get-an-enterprise.md): Retrieve a single enterprise by id. Returns `404` if the id does not exist or does not belong to your account. - [Replace an enterprise](https://developers.telnyx.com/api-reference/enterprises/replace-an-enterprise.md): Replace the enterprise's mutable fields. Only mutable fields may be sent. Server-assigned and immutable fields (`id`, `record_type`, `created_at`, `updated_at`… - [Delete an enterprise](https://developers.telnyx.com/api-reference/enterprises/delete-an-enterprise.md): Soft-delete an enterprise. - [Activate Branded Calling on an enterprise](https://developers.telnyx.com/api-reference/enterprises/activate-branded-calling-on-an-enterprise.md): Branded Calling is a paid product that must be activated on each enterprise. Activation is idempotent: ### Display Identity Records - [List DIRs in an enterprise](https://developers.telnyx.com/api-reference/display-identity-records/list-dirs-in-an-enterprise.md): Return the DIRs (Display Identity Records) belonging to a single enterprise. Pagination is JSON:API style (`page[number]`, `page[size]`, max 250). Supports `fi… - [Create a Display Identity Record (DIR)](https://developers.telnyx.com/api-reference/display-identity-records/create-a-display-identity-record-dir.md): Create a new DIR under the given enterprise. The DIR starts in `draft` status; it must be submitted (`POST .../submit`) and approved by Telnyx before any phone… - [List all DIRs across your enterprises](https://developers.telnyx.com/api-reference/display-identity-records/list-all-dirs-across-your-enterprises.md): Returns every DIR (Display Identity Record) you own, across all of your enterprises, as a single list. Pagination is JSON:API style (`page[number]`, `page[size… - [Get a DIR by id](https://developers.telnyx.com/api-reference/display-identity-records/get-a-dir-by-id.md): Returns a single DIR by id. The enterprise is resolved server-side from the DIR id. Returns `404` if the DIR does not exist or is not yours. - [Update a DIR](https://developers.telnyx.com/api-reference/display-identity-records/update-a-dir.md): Edit a DIR. DIRs in `draft`, `rejected`, `unsuccessful`, or `suspended` can be edited freely: PATCH is a pure edit, `status` is never changed, and you re-vet b… - [Delete a DIR](https://developers.telnyx.com/api-reference/display-identity-records/delete-a-dir.md): Delete a DIR. Failure modes: `400` if a child phone number is in a non-deletable status, `409` if the DIR has an unresolved infringement claim, `404` if the DI… - [Submit a DIR for vetting](https://developers.telnyx.com/api-reference/display-identity-records/submit-a-dir-for-vetting.md): Submit a DIR for vetting. Sends the DIR back through the vetting cycle from any non-terminal status. When re-submitting from `suspended` or `expired`, the DIR'… - [Render the Branded Calling LOA for a DIR](https://developers.telnyx.com/api-reference/display-identity-records/render-the-branded-calling-loa-for-a-dir.md): Generate a pre-filled Letter of Authorization (LOA) PDF for a DIR. Enterprise identity (legal name, DBA, address, contact, website, tax id) and the DIR display… ### Reference Data - [List supported DIR document types](https://developers.telnyx.com/api-reference/reference-data/list-supported-dir-document-types.md): Reference list of `document_type` values accepted by `DirCreateRequest.documents[].document_type` and the infringement-contest endpoint. Each entry has a stabl… - [List standard call reasons](https://developers.telnyx.com/api-reference/reference-data/list-standard-call-reasons.md): Telnyx maintains a library of pre-vetted call-reason phrases (e.g. "Appointment reminders", "Billing inquiries") that carry through DIR vetting smoothly. You c… - [Validate a list of call reasons](https://developers.telnyx.com/api-reference/reference-data/validate-a-list-of-call-reasons.md): Check up to 10 candidate `call_reasons` strings against Telnyx's vetting heuristics before sending them on a DIR create or update. The endpoint flags strings t… ### Comments - [List comments on a DIR](https://developers.telnyx.com/api-reference/comments/list-comments-on-a-dir.md): List the comments on a DIR. The enterprise is resolved server-side from the DIR id. - [Post a comment on a DIR](https://developers.telnyx.com/api-reference/comments/post-a-comment-on-a-dir.md): Post a customer comment on a DIR (for example, to respond to reviewer notes). Send only `content` (1–5000 chars) and an optional `parent_comment_id`; the serve… ### Phone Numbers - [List phone numbers attached to a DIR](https://developers.telnyx.com/api-reference/phone-numbers/list-phone-numbers-attached-to-a-dir.md): List the phone numbers registered under a DIR. The enterprise is resolved server-side from the DIR id. - [Add phone numbers to a DIR](https://developers.telnyx.com/api-reference/phone-numbers/add-phone-numbers-to-a-dir.md): Register phone numbers under a DIR. The enterprise is resolved server-side from the DIR id. Same body, failure modes, and batch semantics whichever path form y… - [Remove phone numbers from a DIR](https://developers.telnyx.com/api-reference/phone-numbers/remove-phone-numbers-from-a-dir.md): Deregister phone numbers from a DIR. The enterprise is resolved server-side from the DIR id. Returns a partial-success envelope. ### Phone Number Batches - [List phone-number batches for a DIR](https://developers.telnyx.com/api-reference/phone-number-batches/list-phone-number-batches-for-a-dir.md): List the phone-number batches submitted under a DIR. The enterprise is resolved server-side from the DIR id. - [Get a phone-number batch](https://developers.telnyx.com/api-reference/phone-number-batches/get-a-phone-number-batch.md): Get a single phone-number batch by id. The enterprise is resolved server-side from the DIR id. ### Infringement Claims - [List infringement claims for a DIR](https://developers.telnyx.com/api-reference/infringement-claims/list-infringement-claims-for-a-dir.md): Return the trademark or copyright claims filed against this DIR. Each claim's `status` is `pending` (newly filed; DIR auto-suspended), `contested` (you have su… - [Update a DIR to resolve an infringement concern](https://developers.telnyx.com/api-reference/infringement-claims/update-a-dir-to-resolve-an-infringement-concern.md): Push a fix for a DIR that is `suspended` with an open infringement claim back into vetting. `POST /dir/{dir_id}/submit` is blocked while a claim is open, so th… - [Get an infringement claim](https://developers.telnyx.com/api-reference/infringement-claims/get-an-infringement-claim.md): Retrieve a single claim by id. Returns `404` if the claim does not exist or is not against a DIR you own. - [Contest an infringement claim](https://developers.telnyx.com/api-reference/infringement-claims/contest-an-infringement-claim.md): Submit a written response and supporting documents disputing the claim. The first call moves the claim from `pending` to `contested`; subsequent calls append s… ### Terms of Service - [Agree to the Branded Calling Terms of Service](https://developers.telnyx.com/api-reference/terms-of-service/agree-to-the-branded-calling-terms-of-service.md): Records the authenticated user's agreement to the current Branded Calling ToS. No body required. Idempotent - re-calling after agreement is a no-op and returns… - [Get Terms of Service information](https://developers.telnyx.com/api-reference/terms-of-service/get-terms-of-service-information.md): Returns the available Terms of Service agreements (product, current version, terms URL, effective date). Omit `product_type` to return all products; pass it to… - [Get the calling user's Terms of Service status](https://developers.telnyx.com/api-reference/terms-of-service/get-the-calling-users-terms-of-service-status.md): 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 whe… - [List the calling user's Terms of Service agreements](https://developers.telnyx.com/api-reference/terms-of-service/list-the-calling-users-terms-of-service-agreements.md): 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 agreeme… - [Get a Terms of Service agreement by id](https://developers.telnyx.com/api-reference/terms-of-service/get-a-terms-of-service-agreement-by-id.md): Retrieve a single ToS agreement record. Returns `404` if the agreement does not exist or does not belong to the authenticated user.