---
title: "Upload Bank Clearing Documents"
method: POST
path: "/api/v1/billing/bank-clearing-documents"
tags: ["Billing"]
---

# Upload Bank Clearing Documents

`POST /api/v1/billing/bank-clearing-documents`

## Request

- Base URL: `https://api.compteam.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.compteam.io/api/v1/billing/bank-clearing-documents`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Response `200`

Successful Response

- BankClearingDocumentsResponse
  - `summary` BankClearingSummary, required
    - `file_count` integer, required
    - `processed_files` integer, required
    - `duplicate_files` integer, required
    - `invalid_files` integer, required
    - `total_rows` integer, required
    - `auto_applied` integer, required
    - `needs_confirm` integer, required
    - `fees_posted` integer, required
    - `fees_pending` integer, required
  - `files` BankClearingFileResult[], required
    - `file_index` integer, required
    - `filename` string, required
    - `status` 'processed' | 'review_required' | 'duplicate' | 'invalid', required
    - `statement_id` string, uuid, nullable
    - `document_type` 'collection_credit' | 'debit_return', nullable
    - `currency` string, nullable
    - `collection_date` string, date, nullable
    - `processing_date` string, date, nullable
    - `linked_sepa_batch_id` string, uuid, nullable
    - `linked_collection_date` string, date, nullable
    - `totals` BankClearingTotals
      - `gross` number, nullable
      - `commission` number, nullable
      - `tax` number, nullable
      - `net` number, nullable
    - `total_rows` integer, required
    - `auto_applied` integer, required
    - `needs_confirm` integer, required
    - `fee_status` 'pending' | 'posted' | 'not_applicable' | 'unavailable', required
    - `pending_rows` BankClearingPendingRow[]
      - `id` string, uuid, required
      - `file_index` integer, required
      - `statement_id` string, uuid, required
      - `document_type` 'collection_credit' | 'debit_return', required
      - `source_page` integer, required
      - `mandate_reference` string, required
      - `booking_date` string, date, nullable
      - `amount` string, required
      - `counterparty` string, required
      - `match` BankClearingPendingMatch, required
        - `action` 'pending_confirm', required
        - `reason` string, required
      - `batch_line_candidates` BankClearingBatchLineCandidate[]
        - `id` string, uuid, required
        - `end_to_end_id` string, required
        - `debtor_name` string, required
        - `amount` number, required
        - `collection_date` string, date, nullable
        - `action` 'mark_paid' | 'reverse_payment', required
        - `date_matches` boolean
        - `name_matches` boolean
        - `eligible` boolean
        - `reason` string, nullable
    - `error` BankClearingFileError
      - `code` string, required
      - `message` string, required
  - `pending_rows` BankClearingPendingRow[], required
    - `id` string, uuid, required
    - `file_index` integer, required
    - `statement_id` string, uuid, required
    - `document_type` 'collection_credit' | 'debit_return', required
    - `source_page` integer, required
    - `mandate_reference` string, required
    - `booking_date` string, date, nullable
    - `amount` string, required
    - `counterparty` string, required
    - `match` BankClearingPendingMatch, required
      - `action` 'pending_confirm', required
      - `reason` string, required
    - `batch_line_candidates` BankClearingBatchLineCandidate[]
      - `id` string, uuid, required
      - `end_to_end_id` string, required
      - `debtor_name` string, required
      - `amount` number, required
      - `collection_date` string, date, nullable
      - `action` 'mark_paid' | 'reverse_payment', required
      - `date_matches` boolean
      - `name_matches` boolean
      - `eligible` boolean
      - `reason` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/compteam/apis/c-team-api.md) · [All operations](https://skmtc.dev/compteam/apis/c-team-api/llms.txt) · [OpenAPI document](https://skmtc.dev/compteam/apis/c-team-api/revisions/4bd27c892655?raw)