---
title: "Submit one bank statement; transactions already stored are dropped as duplicates"
method: POST
path: "/api/agent/v1/bank-statements"
---

# Submit one bank statement; transactions already stored are dropped as duplicates

`POST /api/agent/v1/bank-statements`

## Request

- Base URL: `https://declararfacil.com`
- URL: `https://declararfacil.com/api/agent/v1/bank-statements`
- Auth: HTTP bearer

## Request body

- BankStatementInput
  - `bankName` string, nullable
  - `bankBIC` string, nullable
  - `accountIBAN` string, nullable
  - `periodStart` string, nullable: YYYY-MM-DD
  - `periodEnd` string, nullable: YYYY-MM-DD
  - `openingBalance` number, nullable
  - `closingBalance` number, nullable
  - `source_file` string, nullable
  - `transactions` object[], required
    - `date` string, required: YYYY-MM-DD
    - `valueDate` string, nullable
    - `concept` string, required: The statement line text, complete
    - `counterpartyName` string, nullable
    - `counterpartyIBAN` string, nullable
    - `amount` number, required: Negative for debits, positive for credits, in EUR
    - `category` string, nullable: SEGURIDAD_SOCIAL, COMISIONES_BANCARIAS, IMPUESTOS, ALQUILER, SUMINISTROS, OTROS, or null
    - `reference` string, nullable

## Response `200`

OK

## Other responses

- `401`: invalid_token: unknown or replaced token; start a new connection with POST /api/agent/v1/connect
- `402`: subscription_required: no active subscription; the body carries subscribe_url, steps, next_step and tell_the_user

---

[API](https://skmtc.dev/declararfacil/apis/declarar-facil-agent-api.md) · [All operations](https://skmtc.dev/declararfacil/apis/declarar-facil-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/declararfacil/apis/declarar-facil-agent-api/revisions/6d6837a48359?raw)