> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tupana.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener un estado de cuenta

Un estado de cuenta por su id (`ccs_…` en una tarjeta, `bsu_…` en una cuenta
corriente), con la misma forma que en [el listado](https://docs.tupana.ai/api-reference/v2/statements/list.md).
Si el estado de cuenta no es de esa cuenta, o la cuenta no es de tu
integración, responde `404`.

```bash theme={null}
curl https://api.tupana.ai/v2/bank-accounts/bacc_7Hk2938475610293/statements/ccs_7382910465728/ \
  -H "Authorization: Api-Key TU_API_KEY"
```


## OpenAPI

````yaml api-reference/openapi-v2.json GET /bank-accounts/{account_id}/statements/{statement_id}/
openapi: 3.0.0
info:
  title: Tupana API — v2
  description: >-
    API v2 de Tupana: facturación electrónica, cesiones, recaudación, consultas,
    boleta de honorarios y nómina. Los identificadores de recursos son public
    IDs opacos con prefijo (docu_, ment_, cred_, doce_, empl_…).
  version: 2.0.0
servers:
  - url: https://api.tupana.ai/v2
    description: Producción (v2)
security:
  - apiKeyAuth: []
paths:
  /bank-accounts/{account_id}/statements/{statement_id}/:
    get:
      tags:
        - Estados de cuenta
      summary: Obtener un estado de cuenta
      operationId: getBankAccountStatement_v2
      parameters:
        - name: account_id
          in: path
          required: true
          schema:
            type: string
            example: bacc_7Hk2938475610293
        - name: statement_id
          in: path
          required: true
          schema:
            type: string
            example: ccs_7382910465728
      responses:
        '200':
          description: Estado de cuenta
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Statement'
        '403':
          description: >-
            La API key no tiene `banking:read` explícito (`code:
            banking_permission_required`)
        '404':
          description: >-
            El estado de cuenta no es de esa cuenta, o la cuenta no existe para
            esta API key
      security:
        - apiKeyAuth: []
components:
  schemas:
    Statement:
      type: object
      properties:
        id:
          type: string
          example: ccs_7382910465728
          description: '`ccs_…` en una tarjeta, `bsu_…` en una cuenta corriente.'
        account_id:
          type: string
          example: bacc_7Hk2938475610293
        kind:
          type: string
          enum:
            - credit_card
            - bank_account
        period:
          type: string
          example: 2026-10
        period_start:
          type: string
          format: date
          nullable: true
        period_end:
          type: string
          format: date
          nullable: true
        statement_date:
          type: string
          format: date
          nullable: true
        opening_balance:
          type: number
          nullable: true
        closing_balance:
          type: number
          nullable: true
          description: En una tarjeta, lo facturado del período.
        total_billed:
          type: number
          nullable: true
        due_date:
          type: string
          format: date
          nullable: true
        minimum_payment:
          type: number
          nullable: true
        items_count:
          type: integer
        file_url:
          type: string
          format: uri
          nullable: true
          description: PDF original, firmado por tiempo (1 h).
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        API Key para autenticación. Debe proporcionarse en el header
        Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo
        'Api-Key ' seguido de tu API key)

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.