v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
Infringement Claims

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

Path parameters

claim_idstring uuid required
Example:e379fbc8-cd83-4bef-a280-a0ac9d00dcf8

Unique identifier of the claim.

Request body

contest_notesstring required

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

Example request

{
  "contest_notes": "We own the trademark outright; our registration precedes the claimant by three years.",
  "documents": [
    {
      "description": "Certificate of incorporation.",
      "document_id": "2a7e8337-e803-4057-a4ae-26c40eb0bc6c",
      "document_type": "business_registration"
    }
  ]
}

Response

Updated claim, status contested.

Example response

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