> ## 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 document

> Creates a new document for a case using a document template.



## OpenAPI

````yaml /api-reference/api.yaml post /filings/documents/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:
  /filings/documents/create:
    post:
      tags:
        - filings
      summary: Create a document
      description: Creates a new document for a case using a document template.
      operationId: postFilingsDocumentsCreate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - caseID
                - documentID
              properties:
                caseID:
                  type: string
                  description: ID of the case to file into.
                  example: 2025-08-00125
                documentID:
                  type: string
                  description: Identifier of the document type/template.
                  example: statementOfClaim
                fields:
                  type: object
                  additionalProperties:
                    type: string
                  description: Key-value field inputs for the document.
                  example:
                    respondentName: Mike Smith
                    respondentAddress: 123 Main Street
      responses:
        '200':
          description: Document successfully filed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  filingID:
                    type: string
                    description: ID of the created filing.
                    example: '3'
        '404':
          description: Case not found or user not a participant.
          content:
            text/plain:
              schema:
                type: string
                example: case not found
        '409':
          description: User is an observer and cannot file.
          content:
            text/plain:
              schema:
                type: string
                example: >-
                  you are registered as an observer and cannot file documents in
                  this case
        '410':
          description: The document cannot be filed at this phase.
          content:
            text/plain:
              schema:
                type: string
                example: document not allowed in this phase
        '411':
          description: Filing deadline has passed.
          content:
            text/plain:
              schema:
                type: string
                example: filing deadline for this document has closed
        '412':
          description: Filing limit reached for this document type.
          content:
            text/plain:
              schema:
                type: string
                example: filing limit for this document type reached
        '422':
          description: Validation errors for submitted fields.
          content:
            application/json:
              schema:
                type: object
                properties:
                  validationErrors:
                    type: array
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          description: Field or section with an error.
                          example: respondentName
                        message:
                          type: string
                          description: Human-readable error.
                          example: must be at least 20 characters.
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: access token
      scheme: bearer
      bearerFormat: JWT

````