Contest an infringement claim

Submit a written response and supporting documents disputing the claim. The first call moves the claim from pending to contested; subsequent calls append supplementary evidence without changing status. The documents[] you attach are aggregated across rounds in the claim’s contest_documents field.

Only pending and contested claims accept new evidence. A resolved claim returns 400.

Failure modes:

400 - the claim is resolved (terminal); cannot be contested further.
404 - the claim does not exist or is not against a DIR you own.
422 - contest_notes is too short (< 10 chars), too long (> 2000 chars), documents is > 20 entries, or a document_id is duplicated within the same submission.

POST

infringement_claims

{claim_id}

contest

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const response = await client.infringementClaims.contest('e379fbc8-cd83-4bef-a280-a0ac9d00dcf8', {
  contest_notes:
    'We own the trademark outright; our registration precedes the claimant by three years. See attached certificate.',
  documents: [
    {
      document_id: '2a7e8337-e803-4057-a4ae-26c40eb0bc6c',
      document_type: 'trademark_registration',
      description: 'USPTO trademark certificate.',
    },
  ],
});

console.log(response.data);

{
  "data": {
    "id": "e379fbc8-cd83-4bef-a280-a0ac9d00dcf8",
    "dir_id": "42a3f554-7ce3-44c2-bfe9-6e1afe0d7991",
    "enterprise_id": "7eca8226-8081-4e11-abdc-437b5f53a81f",
    "claim_description": "Alleged infringement on trademark XYZ.",
    "claimant_name": "Test Claimant LLC",
    "claimant_contact": "legal@testclaimant.example.com",
    "claim_date": "2026-04-22T02:12:54Z",
    "resolution_date": "2023-11-07T05:31:56Z",
    "resolution_notes": "<string>",
    "contest_documents": [
      {
        "document_id": "2a7e8337-e803-4057-a4ae-26c40eb0bc6c",
        "document_type": "business_registration",
        "description": "Certificate of incorporation."
      }
    ],
    "contest_history": [
      {
        "notes": "We own the trademark outright; our registration precedes the claimant by three years.",
        "submitted_at": "2026-04-22T02:13:06.629473Z",
        "document_count": 1
      }
    ],
    "dir": {
      "id": "42a3f554-7ce3-44c2-bfe9-6e1afe0d7991",
      "display_name": "Acme Plumbing",
      "enterprise_id": "7eca8226-8081-4e11-abdc-437b5f53a81f"
    },
    "created_at": "2026-04-22T02:12:55.908411Z",
    "updated_at": "2026-04-22T02:12:55.908417Z"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

claim_id

string<uuid>

required

Unique identifier of the claim.

Example:

"e379fbc8-cd83-4bef-a280-a0ac9d00dcf8"

Body

application/json

contest_notes

string

required

Customer's response to the claim. 10–2000 characters.

Required string length: 10 - 2000

Example:

"We own the trademark outright; our registration precedes the claimant by three years."

documents

object[]

Up to 20 supporting documents per submission. document_id must be unique within this submission. Documents are aggregated into the claim's contest_documents across all submissions.

Maximum array length: 20

Show child attributes

Response

Updated claim, status contested.

data

object

required

Show child attributes

Get an infringement claim

Agree to the Branded Calling Terms of Service

⌘I

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});

const response = await client.infringementClaims.contest('e379fbc8-cd83-4bef-a280-a0ac9d00dcf8', {
  contest_notes:
    'We own the trademark outright; our registration precedes the claimant by three years. See attached certificate.',
  documents: [
    {
      document_id: '2a7e8337-e803-4057-a4ae-26c40eb0bc6c',
      document_type: 'trademark_registration',
      description: 'USPTO trademark certificate.',
    },
  ],
});

console.log(response.data);

{
  "data": {
    "id": "e379fbc8-cd83-4bef-a280-a0ac9d00dcf8",
    "dir_id": "42a3f554-7ce3-44c2-bfe9-6e1afe0d7991",
    "enterprise_id": "7eca8226-8081-4e11-abdc-437b5f53a81f",
    "claim_description": "Alleged infringement on trademark XYZ.",
    "claimant_name": "Test Claimant LLC",
    "claimant_contact": "legal@testclaimant.example.com",
    "claim_date": "2026-04-22T02:12:54Z",
    "resolution_date": "2023-11-07T05:31:56Z",
    "resolution_notes": "<string>",
    "contest_documents": [
      {
        "document_id": "2a7e8337-e803-4057-a4ae-26c40eb0bc6c",
        "document_type": "business_registration",
        "description": "Certificate of incorporation."
      }
    ],
    "contest_history": [
      {
        "notes": "We own the trademark outright; our registration precedes the claimant by three years.",
        "submitted_at": "2026-04-22T02:13:06.629473Z",
        "document_count": 1
      }
    ],
    "dir": {
      "id": "42a3f554-7ce3-44c2-bfe9-6e1afe0d7991",
      "display_name": "Acme Plumbing",
      "enterprise_id": "7eca8226-8081-4e11-abdc-437b5f53a81f"
    },
    "created_at": "2026-04-22T02:12:55.908411Z",
    "updated_at": "2026-04-22T02:12:55.908417Z"
  }
}