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

# Exportar transações

> Exporta transacoes com filtros. O limite confirmado e de 10.000 itens por exportacao.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/transaction/exports
openapi: 3.1.1
info:
  title: Veepag API
  description: >-
    API publica da Veepag para transacoes, clientes, assinaturas, produtos,
    cobrancas e alertas.


    Autentique as chamadas com o header `apiKey` no formato `keyId.secret` ou
    com o header `token` contendo um JWT valido.

    Use o ambiente de sandbox para testes e producao apenas depois da
    homologacao.
  version: 1.0.0
  contact: {}
servers:
  - url: https://sandbox.api.veepag.com
    description: Sandbox
  - url: https://api.veepag.com
    description: Produção
security:
  - api_key: []
  - token: []
tags:
  - name: Transaction
    description: >-
      Pagamentos avulsos, captura, cancelamento, consulta e exportacao de
      transacoes.
  - name: Client
    description: Cadastro, atualizacao e consulta de clientes.
  - name: Subscription
    description: Criacao, consulta, atualizacao e cancelamento de assinaturas.
  - name: Product
    description: Configuracao de produtos, precos e regras de cobranca.
  - name: Charge
    description: Criacao, pagamento, cancelamento e conciliacao de cobrancas.
  - name: Alert
    description: Consulta e tratamento de alertas Ethoca/Visa.
paths:
  /v1/transaction/exports:
    get:
      tags:
        - Transaction
      summary: Exportar transações
      description: >-
        Exporta transacoes com filtros. O limite confirmado e de 10.000 itens
        por exportacao.
      operationId: TransactionController_downloadTransactions
      parameters:
        - name: rangeTime.end
          required: false
          in: query
          description: Range end (ISO string). Used with sort.property.
          schema:
            type: string
            format: date-time
            example: '2026-06-23T23:59:59.999Z'
        - name: rangeTime.start
          required: false
          in: query
          description: Range start (ISO string). Used with sort.property.
          schema:
            type: string
            format: date-time
            example: '2026-06-01T00:00:00.000Z'
        - name: message
          required: false
          in: query
          description: Message contains (case-insensitive)
          schema:
            type: string
            description: Busca parcial case-insensitive.
        - name: brandCard
          required: false
          in: query
          description: Card brand filter
          schema:
            type: string
        - name: cardLast4
          required: false
          in: query
          description: Last 4 digits of the card
          schema:
            type: string
            minLength: 4
            maxLength: 4
            example: '1111'
        - name: cardFirst6
          required: false
          in: query
          description: First 6 digits of the card (BIN)
          schema:
            type: string
            minLength: 6
            maxLength: 6
            example: '411111'
        - name: sort.order
          required: false
          in: query
          description: Sort direction (asc|desc)
          schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
            example: desc
        - name: sort.property
          required: false
          in: query
          description: Range field (createdAt|lastUpdate)
          schema:
            type: string
            enum:
              - createdAt
              - lastUpdate
            default: createdAt
            example: createdAt
        - name: status
          required: false
          in: query
          description: Transaction status (multiple values allowed)
          schema:
            type: array
            items: {}
        - name: clientId
          required: false
          in: query
          description: Client ID
          schema:
            type: string
        - name: productId
          required: false
          in: query
          description: Product ID
          schema:
            type: string
        - name: subscriptionId
          required: false
          in: query
          description: Subscription ID
          schema:
            type: string
        - name: tid
          required: false
          in: query
          description: Transaction TID
          schema:
            type: string
        - name: id
          required: false
          in: query
          description: Transaction ID
          schema:
            type: string
      responses:
        '200':
          description: Transacoes exportadas.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Transaction'
              example: []
        '400':
          description: Validation error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error_messages:
                  - msg: Payload invalido.
                    type: field
                    path: companyId
                    location: body
                code: ZodValidationException
                path: /v1/transaction/exports
                metadata: {}
        '401':
          description: Credencial ausente ou invalida.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error_messages:
                  - msg: Unauthorized.
                code: unauthorized
                path: /v1/transaction/exports
                metadata: {}
        '403':
          description: Credencial sem acesso ao recurso ou empresa solicitada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error_messages:
                  - msg: Forbidden.
                code: forbidden
                path: /v1/transaction/exports
                metadata: {}
        '500':
          description: Erro interno nao mapeado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error_messages:
                  - msg: Unknown server error.
                code: unknown_server_error
                path: /v1/transaction/exports
                metadata: {}
      security:
        - api_key: []
        - token: []
components:
  schemas:
    Transaction:
      type: object
      properties:
        _id:
          type: string
          description: ID da transacao.
        companyId:
          type: string
          description: ID da empresa vinculada a transacao.
        clientId:
          type: string
          description: ID do cliente vinculado, quando houver.
        productId:
          type: string
          description: ID do produto vinculado, quando houver.
        subscriptionId:
          type: string
          description: ID da assinatura vinculada, quando houver.
        chargeId:
          type: string
          description: ID da cobranca vinculada, quando houver.
        amount:
          type: number
          description: >-
            Valor da transacao, normalmente com value em centavos e currency
            BRL.
        installments:
          type: number
          description: Parcelamento da transacao.
        paymentMethod:
          $ref: '#/components/schemas/PaymentMethod'
          description: Meio de pagamento usado na transacao.
        status:
          $ref: '#/components/schemas/TransactionStatus'
          description: Status atual da transacao.
        message:
          type: string
          description: Mensagem principal retornada pelo processamento.
        message2:
          type: string
          description: Mensagem complementar retornada pelo processamento.
        card:
          type: object
          additionalProperties: true
          description: Dados de cartao salvos internamente, quando houver.
        acquirer:
          type: object
          additionalProperties: true
          description: Dados da adquirente vinculada a transacao.
        boleto:
          type:
            - object
            - 'null'
          additionalProperties: true
          description: Dados de boleto, quando gerados.
        qrCode:
          type:
            - object
            - 'null'
          additionalProperties: true
          description: Dados de Pix, quando gerados.
        metadata:
          type: object
          additionalProperties: true
          description: Metadados livres vinculados a transacao.
        createdAt:
          type: string
          format: date-time
          description: Data de criacao da transacao.
        lastUpdate:
          type: string
          format: date-time
          description: Data da ultima atualizacao da transacao.
    ErrorResponse:
      type: object
      properties:
        error_messages:
          type: array
          items:
            $ref: '#/components/schemas/ErrorMessage'
        code:
          type: string
          example: unauthorized
        path:
          type: string
          example: /v1/transaction
        metadata:
          type: object
          additionalProperties: true
    PaymentMethod:
      type: string
      enum:
        - CREDIT_CARD
        - DEBIT_CARD
        - BOLETO
        - PIX
    TransactionStatus:
      type: string
      enum:
        - PAID
        - PROCESSING
        - DECLINED
        - CANCELED
        - DISCARDED
        - AUTHORIZED
        - IN_ANALYSIS
        - ERROR_PAYMENT
        - DISPUTE
        - STANDBY
        - CHARGEBACK
        - PENDING_REVIEW
        - PENDING_3DS
        - BLOCKED
        - INVALID_PAYMENT
        - NO_PAYMENT_ROUTE
        - PENDING_PAYMENT
        - ERROR_REFUNDED
    ErrorMessage:
      type: object
      properties:
        msg:
          type: string
          example: Unauthorized.
        type:
          type: string
          example: field
        path:
          type: string
          example: companyId
        location:
          type: string
          example: body
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: apiKey
      description: API key no formato keyId.secret.
    token:
      type: apiKey
      in: header
      name: token
      description: JWT valido. O token confirmado na codebase tem validade de 14 dias.

````