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

> Files each case in the claim to the card network.



## OpenAPI

````yaml /api-reference/v2/openapi.yaml post /v2/issuer/claims/{claim_id}/file
openapi: 3.0.0
info:
  title: Decisionly API v2
  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: v2 Cases
    description: Case management endpoints
  - name: v2 Claims
    description: Claim management endpoints
  - name: v2 Events
    description: Event endpoints
  - name: v2 Files
    description: File upload endpoints
  - name: v2 Beta
    description: Beta features - These endpoints are experimental and subject to change
paths:
  /v2/issuer/claims/{claim_id}/file:
    post:
      tags:
        - v2 Claims
      summary: File a claim
      description: Files each case in the claim to the card network.
      parameters:
        - name: claim_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                file_mode:
                  type: string
                  description: >-
                    Filing mode. Use 'auto' to evaluate workflow rules and
                    determine which cases to file, or 'chargeback' to file all
                    cases regardless of workflow rules.
                  enum:
                    - chargeback
                    - auto
              required:
                - file_mode
      responses:
        '202':
          description: >-
            Accepted. The filing process has been initiated. Returns results for
            each case showing whether it passed validation. Cases that fail
            validation will not be filed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    description: Filing results for each case in the claim.
                    items:
                      type: object
                      properties:
                        case_id:
                          type: string
                          description: The case ID.
                        errors:
                          type: array
                          description: Validation errors, if any.
                          items:
                            type: object
                            properties:
                              code:
                                type: string
                              details:
                                type: object
                              message:
                                type: string
                        success:
                          type: boolean
                          description: Whether the case passed validation and was filed.
              examples:
                all_valid:
                  summary: All cases valid and filed
                  value:
                    results:
                      - case_id: case_xyz789
                        success: true
                partial_success:
                  summary: Partial success - some cases invalid
                  value:
                    results:
                      - case_id: case_xyz789
                        success: true
                      - case_id: case_def456
                        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
                        success: false
        '400':
          description: Bad request - cannot file claim.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
              example:
                message: Invalid file_mode parameter.
        '404':
          description: Claim not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
              example:
                message: Claim not found.
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: Use your API key as the username. No password is required.

````