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

# Baixar arquivo da fatura

> Retorna o conteúdo do arquivo diretamente (streaming), e não uma URL de download.
Sem `file-id`, retorna o ZIP com todos os arquivos da fatura (`invoice-files.zip`);
com `file-id`, retorna apenas o arquivo especificado, com o `Content-Type` e o nome
(via `Content-Disposition`) do arquivo original.




## OpenAPI

````yaml openapi.yaml GET /v1/invoices/{invoice-id}/download
openapi: 3.1.0
info:
  title: Pipo Public API
  version: 0.2.0
  description: >
    API pública da Pipo Saúde para integração de movimentações de benefícios

    (inclusões, exclusões e consultas) por parceiros e sistemas de folha de
    pagamento.
  contact:
    name: Pipo Engineering
    email: felipe.rodopoulos@piposaude.com.br
servers:
  - url: https://api.pipo.health
    description: Homologação (staging)
  - url: https://api.piposaude.com.br
    description: Produção
security:
  - bearerAuth: []
tags:
  - name: Autenticação
    description: Obtenção do token de acesso.
  - name: Empresas
    description: Consulta de empresas e seus produtos.
  - name: Benefícios
    description: Consulta de produtos/benefícios disponíveis.
  - name: Faturas
    description: Consulta de faturas, boletos e status de pagamento.
  - name: Movimentações
    description: Inclusões, exclusões e histórico de movimentações.
  - name: Membros
    description: Consulta de membros e seus benefícios.
  - name: Solicitações
    description: Consulta do status de requisições assíncronas.
  - name: Health Check
    description: Verificação de disponibilidade.
paths:
  /v1/invoices/{invoice-id}/download:
    get:
      tags:
        - Faturas
      summary: Baixar arquivo da fatura
      description: >
        Retorna o conteúdo do arquivo diretamente (streaming), e não uma URL de
        download.

        Sem `file-id`, retorna o ZIP com todos os arquivos da fatura
        (`invoice-files.zip`);

        com `file-id`, retorna apenas o arquivo especificado, com o
        `Content-Type` e o nome

        (via `Content-Disposition`) do arquivo original.
      parameters:
        - name: invoice-id
          in: path
          required: true
          schema:
            type: string
          description: ID da fatura.
        - name: file-id
          in: query
          required: false
          schema:
            type: string
          description: ID de um arquivo específico da fatura, obtido em `files[].file-id`.
          example: 789e0123-e89b-12d3-a456-426614174008
      responses:
        '200':
          description: >
            Conteúdo binário do arquivo. `Content-Type` é `application/zip`
            quando `file-id` não

            é informado (ZIP com todos os arquivos), `application/pdf` para
            boletos, ou

            `application/octet-stream` como fallback. `Content-Disposition` traz
            o nome do

            arquivo (ex.: `attachment; filename="boleto-01.pdf"`).
          headers:
            Content-Disposition:
              schema:
                type: string
              description: >-
                Nome do arquivo para download, ex.: `attachment;
                filename="boleto-01.pdf"`.
            Content-Length:
              schema:
                type: integer
              description: Tamanho do arquivo em bytes, quando disponível.
          content:
            application/zip:
              schema:
                type: string
                format: binary
            application/pdf:
              schema:
                type: string
                format: binary
            application/octet-stream:
              schema:
                type: string
                format: binary
        '404':
          description: Fatura ou arquivo não encontrado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Invoice not found
        '503':
          description: Armazenamento de arquivos indisponível.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Invoice file storage unavailable
components:
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Mensagem descritiva do erro.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Token Bearer obtido em `POST /v1/authenticate`.

````