---
title: "List infringement claims for a DIR"
method: GET
path: "/dir/{dir_id}/infringement_claims"
tags: ["Infringement Claims"]
---

# List infringement claims for a DIR

`GET /dir/{dir_id}/infringement_claims`

Return the trademark or copyright claims filed against this DIR. Each claim's `status` is `pending` (newly filed; DIR auto-suspended), `contested` (you have submitted contest evidence; awaiting resolution), or `resolved` (final). Resolution outcomes: `upheld` (claim accepted; DIR stays suspended/permanently_rejected), `rejected` (claim dismissed; DIR restored to `verified`), `modified` (partial outcome).

## Path parameters

- `dir_id` string, uuid, required

## Query parameters

- `page[number]` integer
- `page[size]` integer

## Response `200`

Paginated list of claims for this DIR.

- InfringementClaimList
  - `data` InfringementClaim[], required
    - `id` string, uuid
    - `dir_id` string, uuid
    - `enterprise_id` string, uuid
    - `claim_type` 'trademark' | 'copyright' — Category of infringement being claimed.
    - `claim_description` string
    - `claimant_name` string
    - `claimant_contact` string
    - `claim_date` string, date-time — When the claim was filed (set by the claimant's representative at file time).
    - `status` 'pending' | 'contested' | 'resolved' — Lifecycle status. `pending` - newly filed; the DIR is auto-suspended. `contested` - you have submitted contest evidence; awaiting Telnyx review. `resolved` - final.
    - `resolution` 'upheld' | 'rejected' | 'modified', nullable — Set only when `status` is `resolved`.
    - `resolution_date` string, date-time, nullable
    - `resolution_notes` string, nullable
    - `contest_documents` Document[] — Aggregated across all customer contest submissions on this claim.
      - `document_id` string, uuid, required — Id returned by the Telnyx Documents API after you upload the file (upload via `POST /v2/documents`; see https://developers.telnyx.com/api/documents).
      - `document_type` 'letter_of_authorization' | 'business_registration' | 'articles_of_incorporation' | 'tax_document' | 'ein_letter' | 'trademark_registration' | 'website_ownership' | 'business_license' | 'professional_license' | 'government_id' | 'utility_bill' | 'bank_statement' | 'other', required — Type of supporting document. Pick the closest match to what the file actually contains; `other` triggers manual vetting and may slow approval. The matching short_name reference list is at `GET /v2/dir/document_types`.
      - `description` string
    - `contest_history` ContestSubmission[] — Per-round submission audit trail. Each entry records one `POST /infringement_claims/{id}/contest` call (notes, timestamp, document count). Aggregated documents live on `contest_documents`.
      - `notes` string
      - `submitted_at` string, date-time
      - `document_count` integer
    - `dir` InfringementClaimDirRef — Snapshot of the DIR the claim is filed against, embedded for convenience.
      - `id` string, uuid
      - `display_name` string
      - `enterprise_id` string, uuid
      - `status` 'draft' | 'submitted' | 'in_review' | 'verified' | 'rejected' | 'unsuccessful' | 'suspended' | 'expired' | 'infringement_claimed' | 'permanently_rejected' — DIR lifecycle status. - `draft` - newly created; editable; not yet submitted. - `submitted` / `in_review` - Telnyx is reviewing. - `verified` - approved; phone numbers may be attached. - `rejected` - Telnyx rejected this submission; `rejection_reasons` is populated; customer can edit and resubmit. - `unsuccessful` - system-side error during processing; customer can edit and resubmit. - `suspended` - temporarily disabled (e.g. by an active infringement claim). - `expired` - verification expired; customer must resubmit. - `infringement_claimed` - a trademark/impersonation claim is open against this DIR. - `permanently_rejected` - terminal; cannot be resubmitted.
    - `created_at` string, date-time
    - `updated_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/revisions/8f5f4e537994/schema)