---
title: "Create Dispute"
method: POST
path: "/api/disputes"
tags: ["Disputes", "disputes"]
---

# Create Dispute

`POST /api/disputes`

Submit a dispute for an invoice.

Creator can dispute specific line items with reasons and evidence.

## Request body

- CreateDisputeRequest
  - `invoice_id` integer, required
  - `line_items` DisputeLineItem[], required
    - `line_item_id` integer, required
    - `reason` 'incorrect_views' | 'incorrect_rpm' | 'optimization_not_applied' | 'video_deleted' | 'channel_demonetized' | 'measurement_period_wrong' | 'duplicate_charge' | 'other', required
    - `claimed_value` union
      - number
      - string
    - `explanation` string, required
  - `supporting_evidence_url` string, nullable

## Response `200`

Successful Response

- DisputeResponse
  - `dispute_id` integer, required
  - `status` string, required
  - `created_at` string, date-time, required
  - `message` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/primetime/apis/primetime-media-api.md) · [All operations](https://skmtc.dev/primetime/apis/primetime-media-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/primetime/primetime-media-api/revisions/9da9a9f64e11/schema)