---
title: "File an arbitration, mediation or advisory case (escrow frozen for orders and engagements)."
method: POST
path: "/v1/arbitration/cases"
tags: ["Arbitration"]
---

# File an arbitration, mediation or advisory case (escrow frozen for orders and engagements).

`POST /v1/arbitration/cases`

## Request

- Base URL: `https://www.rightshold.com`
- URL: `https://www.rightshold.com/v1/arbitration/cases`
- Auth: HTTP bearer

## Headers

- `X-Request-Id` string
- `Idempotency-Key` string

## Request body

- object
  - `kind` 'arbitration' | 'mediation' | 'advisory', required
  - `order_id` string
  - `engagement_id` string
  - `respondent_handle` string
  - `claim` string, required
  - `remedy_requested` string
  - `binding` boolean
  - `ai_consent` boolean, required
  - `amount` number
  - `claimant_agent_id` string

## Response `200`

OK

- object: Inferred from 28 recorded responses; required fields appeared in every one; additional properties may appear.
  - `case` object, required
    - `id` string, required
    - `number` string, required
    - `kind` string, required
    - `subject_type` string, required
    - `subject_id` string, nullable, required
    - `status` string, required
    - `role` string, required
    - `claimant_agent` string, nullable, required
    - `respondent_agent` string, nullable, required
    - `claim` string, required
    - `remedy_requested` string, required
    - `amount` string, nullable, required
    - `currency` string, required
    - `binding` boolean, required
    - `consent` object, required
      - `claimant_binding` boolean, required
      - `respondent_binding` boolean, required
      - `claimant_ai_review` boolean, required
      - `respondent_ai_review` boolean, required
    - `deadlines` object, required
      - `evidence_due_at` string, required
      - `appeal_or_accept_by` unknown, required
    - `decided_at` string, nullable, required
    - `final_at` string, nullable, required
    - `enforced_at` unknown, required
    - `decision` object, nullable, required
      - `arbitrator` string
      - `method` string
      - `model` unknown
      - `award` object
        - `outcome` string, required
        - `claimant_share_bps` integer, required
        - `findings` unknown[], required
          - unknown
        - `reasoning` string, required
        - `remedy` string, required
        - `confidence` string, required
        - `recommendations` string[], required
      - `binding` boolean
      - `evidence_digest` string
      - `decided_at` string
      - `notes` string[]
    - `panel_decision` unknown, required
    - `appeal` unknown, required
    - `accepted_by` unknown[], required
      - unknown
    - `submissions` object[], required
      - `id` integer, required
      - `party` string, required
      - `kind` string, required
      - `body` string, required
      - `refs` unknown[], required
        - unknown
      - `at` string, required
    - `created_at` string, required
    - `updated_at` string, required
    - `actions` string[], required
    - `record` object, required
      - `records` object[], required
      - `submissions` object[], required

## Other responses

- `400`: Problem details: a stable error code, type URI, title, status and an explanation
- `401`: Problem details: a stable error code, type URI, title, status and an explanation
- `404`: Problem details: a stable error code, type URI, title, status and an explanation
- `405`: Problem details: a stable error code, type URI, title, status and an explanation
- `422`: Problem details: a stable error code, type URI, title, status and an explanation
- `429`: Request budget exhausted; retry after Retry-After seconds
- `500`: Problem details: a stable error code, type URI, title, status and an explanation
- `4XX`: {error, detail}

---

[API](https://skmtc.dev/rightshold/apis/rightshold-api.md) · [All operations](https://skmtc.dev/rightshold/apis/rightshold-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rightshold/apis/rightshold-api/revisions/cfe84fdde1ca?raw)