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

# Create a claim

> Creates a new claim by grouping existing cases together.



## OpenAPI

````yaml /api-reference/v2/openapi.yaml post /v2/issuer/claims
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:
    post:
      tags:
        - v2 Claims
      summary: Create a claim
      description: Creates a new claim by grouping existing cases together.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ClaimCreate'
            examples:
              basic:
                summary: Create claim from existing cases
                value:
                  case_ids:
                    - case_abc123
                    - case_def456
                    - case_ghi789
      responses:
        '201':
          description: Returns the newly created claim with associated cases.
          content:
            application/json:
              schema:
                type: object
                properties:
                  cases:
                    type: array
                    items:
                      type: object
                      properties:
                        case_id:
                          type: string
                  claim_id:
                    type: string
                    example: claim_abc123
                  created:
                    type: string
                    format: date-time
                  status:
                    type: string
                    example: open
                  updated:
                    type: string
                    format: date-time
              example:
                cases:
                  - case_id: case_abc123
                  - case_id: case_def456
                claim_id: claim_abc123
                created: '2026-04-01T00:00:00.000Z'
                status: open
        '400':
          description: Bad request - validation errors.
          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:
                missing_case_ids:
                  summary: case_ids parameter missing or invalid
                  value:
                    errors:
                      - code: parameter_missing
                        details:
                          field: case_ids
                        message: case_ids is required and must be an array of case IDs.
                    message: Invalid data.
                empty_case_ids:
                  summary: case_ids array is empty
                  value:
                    errors:
                      - code: parameter_invalid
                        details:
                          field: case_ids
                        message: case_ids must contain at least one case ID.
                    message: Invalid data.
                cases_not_found:
                  summary: Some cases do not exist
                  value:
                    errors:
                      - code: parameter_invalid
                        details:
                          field: case_ids
                        message: 'Cases not found: case_xyz789, case_mno012'
                    message: Invalid data.
                invalid_claim_validation:
                  summary: Cases don't meet claim-level constraints
                  value:
                    errors:
                      - code: parameter_invalid
                        message: >-
                          All cases in a non-fraud claim must have the same
                          merchant
                    message: Invalid claim.
components:
  schemas:
    ClaimCreate:
      type: object
      properties:
        case_ids:
          type: array
          description: >-
            Array of case IDs to group into this claim. All cases must already
            exist.
          items:
            type: string
          minItems: 1
          example:
            - case_abc123
            - case_def456
        claim_id:
          description: >-
            Optional unique identifier for the claim. If not provided, one will
            be generated automatically.
          type: string
          nullable: true
          maxLength: 126
          example: claim_abc123
      required:
        - case_ids
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: Use your API key as the username. No password is required.

````