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

Un movimiento por su id (`move_…`), con la misma forma que en
[el listado](https://docs.tupana.ai/api-reference/v2/movements/list.md).

```bash theme={null}
curl https://api.tupana.ai/v2/movements/move_Qm8102938475612/ \
  -H "Authorization: Api-Key TU_API_KEY"
```

Si el movimiento es de una cuenta de una empresa que no está conectada a tu
integración, o no existe, responde `404`.


## OpenAPI

````yaml api-reference/openapi-v2.json GET /movements/{movement_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:
  /movements/{movement_id}/:
    get:
      tags:
        - Movimientos
      summary: Obtener un movimiento
      operationId: getMovement_v2
      parameters:
        - name: movement_id
          in: path
          required: true
          schema:
            type: string
            example: move_Qm8102938475612
      responses:
        '200':
          description: Movimiento
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Movement'
        '403':
          description: >-
            La API key no tiene `banking:read` explícito (`code:
            banking_permission_required`)
        '404':
          description: El movimiento no existe para esta API key
      security:
        - apiKeyAuth: []
components:
  schemas:
    Movement:
      type: object
      properties:
        id:
          type: string
          example: move_Qm8102938475612
        account_id:
          type: string
          example: bacc_7Hk2938475610293
        company_id:
          type: string
          example: ment_3672486436546233854
        amount:
          type: number
          example: 450000
          description: Sin signo. Entero en CLP.
        direction:
          type: string
          enum:
            - inbound
            - outbound
        currency:
          type: string
          example: CLP
        status:
          type: string
          enum:
            - pending
            - posted
            - removed
        posted_movement_id:
          type: string
          nullable: true
          description: >-
            En una pendiente retirada: el id del movimiento posteado que la
            reemplazó.
        transaction_date:
          type: string
          format: date
          nullable: true
        post_date:
          type: string
          format: date
          nullable: true
        description:
          type: string
          description: La glosa tal cual la entrega el banco.
        balance_after:
          type: number
          nullable: true
          description: >-
            Saldo de la cuenta tras el movimiento, cuando la fuente lo entrega
            (cartolas).
        counterparty:
          $ref: '#/components/schemas/Counterparty'
        category:
          type: string
          nullable: true
          enum:
            - customer_payment
            - supplier_payment
            - payroll
            - taxes
            - bank_fees
            - internal_transfer
            - card_settlement
          description: >-
            Clasificación Tupana del movimiento. `null` si no se clasificó o no
            se identificó.
        card:
          type: object
          nullable: true
          description: Solo en movimientos de una cuenta de crédito.
          properties:
            last_four:
              type: string
              example: '2105'
            merchant:
              type: string
              nullable: true
              example: AMAZON WEB SERVICES
            installments:
              type: integer
              nullable: true
              description: '`null` hasta que la fuente lo entregue.'
    Counterparty:
      type: object
      nullable: true
      description: >-
        La contraparte resuelta por Tupana. `null` cuando no hay nada que
        resolver.
      properties:
        tax_id:
          type: string
          nullable: true
          example: 76.543.169-7
        name:
          type: string
          nullable: true
          example: Comercial Andina SpA
        institution:
          type: object
          nullable: true
          properties:
            code:
              type: string
              example: cl_banco_de_chile
            name:
              type: string
              example: Banco de Chile
        account_number_mask:
          type: string
          nullable: true
          example: '0912'
          description: Últimos 4 dígitos. El número completo nunca sale.
  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.