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

# File a case

> Files a case as a chargeback with the card network, bypassing workflow rule evaluation.



## OpenAPI

````yaml /api-reference/v3/openapi.yaml post /v3/issuer/cases/{case_id}/file
openapi: 3.0.0
info:
  title: Decisionly API v3
  description: Claims-based API for submission and handling of chargebacks by issuers.
  version: 2.0.0
servers:
  - url: https://api.decisionly.com
    description: Production server. Use your test key for the sandbox environment.
security:
  - basicAuth: []
tags:
  - name: v3 Cases
    description: Case management endpoints
  - name: v3 Events
    description: Event endpoints
  - name: v3 Files
    description: File upload endpoints
paths:
  /v3/issuer/cases/{case_id}/file:
    post:
      tags:
        - v3 Cases
      summary: File a case
      description: >-
        Files a case as a chargeback with the card network, bypassing workflow
        rule evaluation.
      parameters:
        - name: case_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '202':
          description: Accepted. The filing process has been initiated.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
              example:
                success: true
        '400':
          description: Bad request - validation errors or invalid parameters.
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                        details:
                          type: object
                        message:
                          type: string
                  message:
                    type: string
              examples:
                validation_failed:
                  summary: Case failed validation
                  value:
                    errors:
                      - code: filing_too_late
                        message: >-
                          Transaction date is outside the filing window for this
                          dispute type
                      - code: documentation_missing
                        details:
                          file_category: transaction_receipt
                        message: >-
                          Transaction receipt documentation is required for this
                          dispute reason
                    message: Case failed validation.
                filing_too_late_fraud:
                  summary: Filing deadline exceeded for fraud
                  value:
                    errors:
                      - code: filing_too_late
                        message: >-
                          Chargeback must be filed within 120 days of the
                          transaction date for "Fraud" disputes.
                    message: Case failed validation.
                filing_too_early:
                  summary: Network waiting period has not passed
                  value:
                    errors:
                      - code: filing_too_early
                        details:
                          earliest_filing_date: '2026-05-15'
                        message: >-
                          Chargeback must be filed at least 15 days after the
                          refund promise date.
                    message: Case failed validation.
                removed_field:
                  summary: Removed v2 parameter
                  value:
                    errors:
                      - code: parameter_invalid
                        details:
                          field: file_mode
                        message: >-
                          file_mode is not a recognized field. Use POST
                          /v3/issuer/cases/{case_id}/run_workflow to run your
                          workflow rules.
                    message: Invalid data.
        '404':
          description: Case not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
              example:
                message: Case not found.
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: Use your API key as the username. No password is required.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.