> ## Documentation Index > Fetch the complete documentation index at: https://docs.melso.ai/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Melso MCP: https://mcp.melso.ai/mcp (OAuth; one company per connection). Documentation-search MCP: https://docs.melso.ai/mcp; it does not act on customer accounts. > > Use the live tool list and respect company membership. Ask the person to approve the exact invoice or tax return version in the signed-in app. Melso's professionals prepare and file included returns after approval; an AI assistant does not file. A prepared file or an approval is not evidence of filing: only the AEAT's reference and receipt are. Keep credentials out of chat and logs. # Read a bank statement > Reads a statement file without saving it: Norma 43 (Cuaderno 43), CSV, XLSX or PDF, up to 5 MB and 5,000 movements of one account. **Live capability.** Melso runs this in production today. Partner keys reach it once your partner account is enabled. See [Availability](/api/availability). The format is detected from the content. Returns the movements, the balances, which movements are already saved and whether it can be saved as is. ## OpenAPI ````yaml api/openapi.yaml POST /companies/{company_id}/bank-statements/read openapi: 3.1.0 info: title: Melso API version: 1.0.0-preview summary: Spanish tax and labour compliance for the companies on your platform. description: | The Melso API lets an HR, payroll, banking or ERP platform run the Spanish tax and labour obligations of the companies it serves: invoices, books, tax returns, Social Security and employment notifications. Melso calculates and prepares. A person at the company approves the exact version. Melso's professionals file under the company's representation, and the filing is proven only by the administration's reference and receipt. Every operation states its availability in `x-melso-status`: - `live`: Melso runs this capability in production today. Partner keys reach it once a partner account is enabled. - `preview`: a contract proposed to design partners. Not callable yet. `x-melso-actor: person` marks a decision a signed-in person makes in Melso; a partner sends them the approval link instead. contact: name: Melso partnerships email: hello@melso.ai url: https://docs.melso.ai/api/overview servers: - url: https://api.melso.ai/v1 description: API. Keys and access are issued per partner. security: - partnerKey: [] tags: - name: Companies description: The companies you operate for, their fiscal profile and hosted onboarding. - name: Mandates description: >- The company's representation of Melso before the AEAT, the TGSS and the SEPE. - name: Webhook endpoints description: Where Melso sends signed events about your companies. - name: Invoicing setup description: Registration of the company as a VERI*FACTU or TicketBAI invoice issuer. - name: Customers description: The company's invoice customers. - name: Invoices description: >- Drafts, approval, legal registration, delivery and payment of the company's invoices. - name: Expenses description: >- Purchase invoices and receipts, with their AEAT category and deductibility. - name: Income description: Income invoiced outside Melso. - name: Documents description: >- Files the company gives Melso, and Melso's structured reading of an invoice or receipt. - name: Banking description: >- Bank accounts, movements, statements and reconciliation with invoices and expenses. - name: Accounting description: Journal, imported books and the company's financial statements. - name: Tax calendar description: The forms the company must file, with their periods and deadlines. - name: Tax returns description: The returns Melso calculates, their approval and their filing. - name: Corporate tax description: The year's corporate tax (modelo 200) and its instalments (modelo 202). - name: Tax estimates description: What the company should set aside for taxes, as of today. - name: Cases description: Gestiones, the procedures Melso's professionals carry out for the company. - name: Administration notifications description: Electronic notifications from the administration to the company. - name: Certificates description: >- Official certificates such as being up to date with the AEAT or the Social Security. - name: Employees description: The people the company employs. - name: Payroll runs description: >- The payroll results your platform calculated, for Melso to settle and declare. - name: Social Security description: >- Affiliation (altas, bajas and variaciones) and monthly contribution settlements. - name: Employment notifications description: >- Contrat@ contract notifications and Certific@2 company certificates to the SEPE. paths: /companies/{company_id}/bank-statements/read: parameters: - $ref: '#/components/parameters/CompanyId' post: tags: - Banking summary: Read a bank statement description: | Reads a statement file without saving it: Norma 43 (Cuaderno 43), CSV, XLSX or PDF, up to 5 MB and 5,000 movements of one account. The format is detected from the content. Returns the movements, the balances, which movements are already saved and whether it can be saved as is. operationId: readBankStatement requestBody: required: true content: multipart/form-data: schema: $ref: '#/components/schemas/BankStatementUpload' responses: '200': description: What the file holds. content: application/json: schema: $ref: '#/components/schemas/BankStatementPreview' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '422': description: >- The file cannot be read, is empty, holds several accounts or is of another account. content: application/json: schema: $ref: '#/components/schemas/Error' components: parameters: CompanyId: name: company_id in: path required: true description: >- The company's ID. Every company-scoped call works in exactly this company. schema: type: string format: uuid schemas: BankStatementUpload: type: object required: - file properties: file: type: string format: binary description: >- Norma 43, CSV, XLSX or PDF, up to 5 MB. CSV and XLSX need a header row naming a date and an amount, or a debit and a credit column. bank_account_id: type: string format: uuid description: >- The account. Without it, Melso uses the saved account with the file's IBAN, or creates one. account_name: type: string maxLength: 120 opening_balance: $ref: '#/components/schemas/Amount' closing_balance: $ref: '#/components/schemas/Amount' BankStatementPreview: type: object properties: format: type: string enum: - norma43 - csv - xlsx - pdf iban: type: - string - 'null' currency: type: string period_start: type: string format: date period_end: type: string format: date opening_balance: type: - string - 'null' closing_balance: type: - string - 'null' movement_total: $ref: '#/components/schemas/Amount' difference: type: - string - 'null' description: How far the balances are from the movements. bank_account: oneOf: - $ref: '#/components/schemas/BankAccount' - type: 'null' movements: type: array items: type: object properties: line_number: type: integer booked_on: type: string format: date value_on: type: - string - 'null' format: date amount: $ref: '#/components/schemas/Amount' balance_after: type: - string - 'null' concept: type: string counterparty_name: type: string reference: type: string duplicate: type: boolean new_movements: type: integer duplicates: type: integer questions: type: array description: What a person must answer before saving. items: type: string enum: - account - balances can_save: type: boolean Error: type: object required: - error properties: error: type: string description: What went wrong, for a person to read. code: type: string description: >- A stable code to branch on, such as `invoicing_not_ready` or `version_conflict`. request_id: type: string description: Quote it when you contact Melso. Amount: type: string pattern: ^-?[0-9]+\.[0-9]{2}$ description: >- An amount in euros as a decimal string with two decimals, such as `"121.00"`. examples: - '121.00' BankAccount: type: object required: - id - name - currency - created_at properties: id: type: string format: uuid name: type: string iban: type: - string - 'null' currency: type: string external_id: type: - string - 'null' description: Preview. created_at: type: string format: date-time updated_at: type: string format: date-time responses: BadRequest: description: >- The request is malformed or a field is invalid. Unknown fields are refused. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: lines[0].vat_rate must be 21, 10, 4 or 0 code: invalid_invoice request_id: req_01JAB3K9X2 Unauthorized: description: The key is missing, revoked or invalid. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: invalid token code: unauthorized request_id: req_01JAB3K9X2 PaymentRequired: description: >- The company's plan does not include this service, or its allowance is used up. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: The tax service is not active for this company code: tax_service_required request_id: req_01JAB3K9X2 securitySchemes: partnerKey: type: http scheme: bearer description: | Your partner secret key, `mk_live_…` for real companies or `mk_test_…` for test companies. Keep it on your servers. See [Authentication](/api/authentication). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.