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

# Create a case

> Creates a new arbitration case for the authenticated user's organization. All fields are optional — calling with an empty body creates a case with default settings (14-day response period, default ruleset).




## OpenAPI

````yaml /api-reference/api.yaml post /cases/create
openapi: 3.0.3
info:
  title: api
  description: >-
    The API service is the secure public gateway to our platform, letting people
    access features without touching our private internal APIs. It authenticates
    clients with its own internal tokens and then routes their requests to the
    right internal services behind the scenes.
  version: 1.0.0
servers:
  - url: https://api.platform.arb.inc
security: []
tags:
  - name: cases
  - name: docket
  - name: evidence
  - name: filings
  - name: organization
  - name: participants
  - name: schemas
  - name: service-of-notice
paths:
  /cases/create:
    post:
      tags:
        - cases
      summary: Create a case
      description: >
        Creates a new arbitration case for the authenticated user's
        organization. All fields are optional — calling with an empty body
        creates a case with default settings (14-day response period, default
        ruleset).
      operationId: createCase
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                ruleset:
                  type: string
                  description: >
                    Identifier for the arbitration ruleset to apply to this
                    case. Must be between 1 and 50 characters.
                  default: default
                  example: default
                responseDeadlineDays:
                  type: integer
                  description: >
                    The number of calendar days the respondent is given to
                    respond to the case before it may proceed without them (ex
                    parte). See [Arbitration.Inc
                    Rules](https://arbitration.inc/rules) Article 5.
                  enum:
                    - 14
                    - 21
                    - 30
                  default: 14
                  example: 14
                claimantCoversRespondentFees:
                  type: boolean
                  description: >
                    When true, the claimant absorbs all respondent filing fees,
                    so the respondent is not charged to participate.
                  default: false
                  example: false
      responses:
        '200':
          description: Case successfully created.
          content:
            application/json:
              schema:
                type: object
                properties:
                  caseID:
                    type: string
                    description: Unique ID of the new case.
                    example: 2025-08-00292
                  title:
                    type: string
                    description: Short title for the case.
                    example: Case 2025-08-00292
        '400':
          description: >
            Invalid request. Possible reasons: user is not part of an
            organization, invalid responseDeadlineDays value, invalid ruleset,
            or user has a restricted role (arbitrator or case manager).
          content:
            text/plain:
              schema:
                type: string
                example: responseDeadlineDays must be 14, 21, or 30
        '402':
          description: Insufficient credits to create a case.
          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
                    description: Number of credits required.
                    example: 1
        '403':
          description: User has reached the maximum number of active cases.
          content:
            text/plain:
              schema:
                type: string
                example: too many active cases
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: access token
      scheme: bearer
      bearerFormat: JWT

````