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

# List account transfers of the company, paginated.

> Own, independent listing from GET /companies/transactions (plan.md Decisão A) — transfers never appear in the transactions listing, and clients must not concatenate the two paginated responses on the client side. limit is capped server-side at 100 (usecase.MaxTransferPageSize) regardless of the value requested; values above that are silently truncated, not rejected.



## OpenAPI

````yaml /openapi/extat-openapi.json get /companies/transfers
openapi: 3.0.0
info:
  contact:
    email: contato@cernedigital.io
    name: Cerne Digital
    url: https://cernedigital.io
  description: >-
    API REST da Extat Plataforma usada pelo painel web. Artefato OpenAPI 3.0
    para a documentação Mintlify (tags em PT-BR).
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: http://swagger.io/terms/
  title: Extat Plataforma - API REST
  version: '1.0'
servers:
  - url: https://golang-api-vgnqx.ondigitalocean.app/v1
security: []
tags:
  - name: Autenticação
  - name: Bancos
  - name: Contas Bancárias
  - name: Plano e Assinaturas
  - name: Empresa
  - name: Centros de Custo
  - name: Painel
  - name: Demonstrativos
  - name: Saúde
  - name: Convites
  - name: Membros
  - name: Onboarding
  - name: Fornecedores
  - name: Usuário
paths:
  /companies/transfers:
    get:
      tags:
        - Empresa
      summary: List account transfers of the company, paginated.
      description: >-
        Own, independent listing from GET /companies/transactions (plan.md
        Decisão A) — transfers never appear in the transactions listing, and
        clients must not concatenate the two paginated responses on the client
        side. limit is capped server-side at 100 (usecase.MaxTransferPageSize)
        regardless of the value requested; values above that are silently
        truncated, not rejected.
      parameters:
        - description: company uuid
          in: header
          name: x-company-id
          required: true
          schema:
            type: string
        - description: current page (default 1)
          in: query
          name: page
          schema:
            type: integer
        - description: max results per page (default 10, capped at 100)
          in: query
          name: limit
          schema:
            type: integer
        - description: ILIKE filter over reference
          in: query
          name: search
          schema:
            type: string
        - description: filters transfer_date >= start_date (YYYY-MM-DD)
          in: query
          name: start_date
          schema:
            type: string
        - description: filters transfer_date <= end_date (YYYY-MM-DD)
          in: query
          name: end_date
          schema:
            type: string
        - description: comma-separated bank account uuids; matches origin OR destination
          in: query
          name: bank_accounts
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.PaginatedListResponseDTO'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponseDTO'
          description: >-
            invalid x-company-id, invalid date filter, or invalid uuid in
            bank_accounts
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponseDTO'
          description: Internal Server Error
      security:
        - ApiKeyAuth: []
components:
  schemas:
    handler.PaginatedListResponseDTO:
      properties:
        data: {}
        limit:
          type: integer
        page:
          type: integer
        search:
          type: string
        total:
          type: integer
      required:
        - limit
        - page
      type: object
    handler.ErrorResponseDTO:
      properties:
        error:
          type: string
        message:
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: >-
        Token da sessão no cabeçalho Authorization, no formato Bearer (mesmo
        esquema ApiKeyAuth do contrato).
      in: header
      name: Authorization
      type: apiKey

````