> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.arb.inc/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a new case

> Creates a new arbitration case with the specified ruleset and participant details. Charges the organization for case creation and returns the case ID and title upon success.



## OpenAPI

````yaml api-reference/cases.yaml post /cases/create
openapi: 3.0.3
info:
  title: cases
  description: >-
    The Cases Service is the main place where all case info lives, including who
    is involved and what files are attached. It lets you create new cases, view
    existing ones, upload documents or files, and manage service of notice
    delivery through multiple channels (mail, email, or manual attestation),
    while notifying other parts of the system when anything changes.
  version: 1.0.0
servers:
  - url: https://cases.platform.arb.inc
security: []
tags:
  - name: /
  - name: cases
  - name: docket
  - name: evidence
  - name: filings
  - name: internal
  - name: invites
  - name: participants
  - name: schemas
  - name: service-of-notice
  - name: tasks
  - name: timetables
paths:
  /cases/create:
    post:
      tags:
        - cases
      summary: Create a new case
      description: >-
        Creates a new arbitration case with the specified ruleset and
        participant details. Charges the organization for case creation and
        returns the case ID and title upon success.
      operationId: createCase
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                ruleset:
                  type: string
                  description: Ruleset to apply to the case
                  example: default
                requestId:
                  type: string
                  description: Optional client-provided idempotency hint
                  example: 550e8400-e29b-41d4-a716-446655440000
                responseDeadlineDays:
                  type: integer
                  description: Response period in days (7, 14, 21, or 30)
                  example: 7
                claimantCoversRespondentFees:
                  type: boolean
                  description: Whether claimant covers respondent's fees
                  example: false
      responses:
        '200':
          description: Successfully created case
          content:
            application/json:
              schema:
                type: object
                properties:
                  caseID:
                    type: string
                    example: 2025-08-00292
                  title:
                    type: string
                    example: ARB Case 2025-08-00292
        '402':
          description: Insufficient credits
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: insufficient_credits
                  message:
                    type: string
                    example: >-
                      Insufficient credits to file a case. Please purchase more
                      credits.
                  required:
                    type: number
                    example: 250
        '403':
          description: Too many active cases or user not allowed to create cases
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: access token
      scheme: bearer
      bearerFormat: JWT

````