Skip to content

Violations API

Violations API

The Violations API allows platforms to track, manage, and resolve violations of protected identities.

List Violations

List violations detected on your platform.

Endpoint

GET /v1/lmif/violations

Request

SDK
cURL

const violations = await lmif.violations.list({
  status: 'pending',
  limit: 20
});

curl https://api.lookmaimfamous.com/v1/lmif/violations?status=pending \
  -H "Authorization: Bearer lmif_live_xxx"

Query Parameters

Parameter	Type	Description
`status`	string	`pending`, `resolved`, `enforced`, `appealed`, `dismissed`
`boxId`	string	Filter by box ID
`severity`	string	`low`, `medium`, `high`, `critical`
`limit`	integer	Max items
`offset`	integer	Items to skip

Response

{
  "data": [
    {
      "id": "viol_abc123",
      "boxId": "box_xyz789",
      "identityName": "Taylor Swift",
      "status": "pending",
      "severity": "high",
      "detectedAt": "2024-01-15T10:00:00Z",
      "avatar": {
        "id": "avatar_123",
        "name": "Taylor AI",
        "creatorId": "creator_456",
        "userCount": 5000
      },
      "detection": {
        "confidence": 0.95,
        "layer": 1,
        "classification": "EXACT_MATCH"
      },
      "gracePeriod": {
        "id": "gp_abc123",
        "expiresAt": "2024-02-14T10:00:00Z",
        "daysRemaining": 29
      }
    }
  ],
  "meta": {
    "total": 47,
    "limit": 20,
    "offset": 0
  }
}

Get Violation

Get details of a specific violation.

Endpoint

GET /v1/lmif/violations/{id}

Request

SDK
cURL

const violation = await lmif.violations.get('viol_abc123');

curl https://api.lookmaimfamous.com/v1/lmif/violations/viol_abc123 \
  -H "Authorization: Bearer lmif_live_xxx"

Response

{
  "data": {
    "id": "viol_abc123",
    "boxId": "box_xyz789",
    "identityName": "Taylor Swift",
    "policy": "MONETIZE",
    "status": "pending",
    "severity": "high",
    "detectedAt": "2024-01-15T10:00:00Z",
    "avatar": {
      "id": "avatar_123",
      "name": "Taylor AI",
      "description": "AI companion version of Taylor",
      "imageUrl": "https://...",
      "creatorId": "creator_456",
      "creatorName": "John Doe",
      "userCount": 5000,
      "createdAt": "2023-06-01T00:00:00Z"
    },
    "detection": {
      "confidence": 0.95,
      "layer": 1,
      "classification": "EXACT_MATCH",
      "matchedVariations": ["Taylor Swift", "T. Swift"],
      "imageMatchScore": 0.92,
      "parodyLikelihood": 0.02
    },
    "gracePeriod": {
      "id": "gp_abc123",
      "status": "active",
      "startedAt": "2024-01-15T10:00:00Z",
      "expiresAt": "2024-02-14T10:00:00Z",
      "daysRemaining": 29,
      "notifications": {
        "day0": { "sent": true, "at": "2024-01-15T10:00:00Z" },
        "day7": { "sent": false },
        "day21": { "sent": false },
        "day28": { "sent": false }
      }
    },
    "resolutionOptions": [
      { "type": "license", "description": "Obtain a license" },
      { "type": "remove", "description": "Remove the avatar" },
      { "type": "modify", "description": "Modify to remove likeness" },
      { "type": "appeal", "description": "Appeal the detection" }
    ]
  }
}

Resolve Violation

Mark a violation as resolved.

Endpoint

POST /v1/lmif/violations/{id}/resolve

Request

SDK
cURL

await lmif.violations.resolve('viol_abc123', {
  resolution: 'removed',
  avatarId: 'avatar_123',
  notes: 'Avatar removed by creator'
});

curl -X POST https://api.lookmaimfamous.com/v1/lmif/violations/viol_abc123/resolve \
  -H "Authorization: Bearer lmif_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "resolution": "removed",
    "avatarId": "avatar_123",
    "notes": "Avatar removed by creator"
  }'

Request Body

Field	Type	Required	Description
`resolution`	string	Yes	Resolution type (see below)
`avatarId`	string	Yes	ID of the affected avatar
`licenseId`	string	No	License ID if resolved by licensing
`notes`	string	No	Additional notes

Resolution Types

Type	Description
`licensed`	Obtained a license
`removed`	Avatar was removed
`modified`	Avatar was modified to remove likeness
`parody`	Marked as parody (if allowed)

Response

{
  "data": {
    "id": "viol_abc123",
    "status": "resolved",
    "resolution": "removed",
    "resolvedAt": "2024-01-16T14:00:00Z",
    "gracePeriod": {
      "id": "gp_abc123",
      "status": "resolved"
    }
  }
}

Appeal Violation

Appeal a violation detection.

Endpoint

POST /v1/lmif/violations/{id}/appeal

Request

SDK
cURL

const appeal = await lmif.violations.appeal('viol_abc123', {
  reason: 'parody',
  explanation: 'This is clearly a parody account with satirical content',
  evidence: [
    'https://example.com/screenshot1.jpg',
    'https://example.com/screenshot2.jpg'
  ]
});

curl -X POST https://api.lookmaimfamous.com/v1/lmif/violations/viol_abc123/appeal \
  -H "Authorization: Bearer lmif_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "parody",
    "explanation": "This is clearly a parody account with satirical content",
    "evidence": [
      "https://example.com/screenshot1.jpg"
    ]
  }'

Request Body

Field	Type	Required	Description
`reason`	string	Yes	Appeal reason (see below)
`explanation`	string	Yes	Detailed explanation
`evidence`	string[]	No	URLs to supporting evidence

Appeal Reasons

Reason	Description
`parody`	Content is parody/satire
`false_positive`	Detection is incorrect
`common_name`	Name is common, not the protected identity
`authorized`	Have verbal/informal authorization
`other`	Other reason

Response

{
  "data": {
    "id": "viol_abc123",
    "status": "appealed",
    "appeal": {
      "id": "appeal_xyz789",
      "reason": "parody",
      "status": "pending",
      "submittedAt": "2024-01-16T10:00:00Z",
      "estimatedReviewTime": "24-48 hours"
    },
    "gracePeriod": {
      "id": "gp_abc123",
      "status": "paused"
    }
  }
}

Violation Statuses

Status	Description
`pending`	In grace period, awaiting resolution
`resolved`	Creator complied
`enforced`	Grace period expired, avatar deactivated
`appealed`	Under human review
`dismissed`	False positive, no action needed

Severity Levels

Severity	Description	Typical Grace Period
`critical`	High-profile identity, major violation	30 days
`high`	Clear match, significant user base	30 days
`medium`	Moderate confidence match	30 days
`low`	Low confidence, may be false positive	30 days