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

# Lista as faturas de um cartão, da mais recente para a mais antiga.

> Cobre todo o horizonte já materializado do cartão — desde a primeira fatura até o teto de parcelamento (24 meses à frente, Q2) — sem querystring de período: nenhuma spec define filtro de data para esta rota (T10, decisão sobre a herança da T9). Mês sem lançamento não aparece (Decisão D/P8: fatura só nasce no primeiro lançamento do período).



## OpenAPI

````yaml /openapi/extat-openapi.json get /companies/credit-card-accounts/{id}/invoices
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/credit-card-accounts/{id}/invoices:
    get:
      tags:
        - Empresa
      summary: Lista as faturas de um cartão, da mais recente para a mais antiga.
      description: >-
        Cobre todo o horizonte já materializado do cartão — desde a primeira
        fatura até o teto de parcelamento (24 meses à frente, Q2) — sem
        querystring de período: nenhuma spec define filtro de data para esta
        rota (T10, decisão sobre a herança da T9). Mês sem lançamento não
        aparece (Decisão D/P8: fatura só nasce no primeiro lançamento do
        período).
      parameters:
        - description: company uuid
          in: header
          name: x-company-id
          required: true
          schema:
            type: string
        - description: Credit Card Account ID
          in: path
          name: id
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/credit_card.InvoiceResponseDTO'
                type: array
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponseDTO'
          description: x-company-id inválido
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponseDTO'
          description: cartão não encontrado (inclusive de outra empresa — CC-6)
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponseDTO'
          description: Internal Server Error
      security:
        - ApiKeyAuth: []
components:
  schemas:
    credit_card.InvoiceResponseDTO:
      properties:
        credit_card_account_id:
          type: string
        due_date:
          type: string
        id:
          type: string
        installments_amount:
          type: number
        open_balance:
          type: string
        open_balance_value:
          type: number
        paid_amount:
          type: number
        paid_at:
          description: |-
            PaidAt nil ⇔ fatura ainda não paga, nem total nem parcialmente (RN5:
            TODO pagamento — parcial ou não — fecha a fatura e grava paid_at).
          type: string
        period_end:
          type: string
        period_start:
          type: string
        previous_balance:
          type: number
        reference_month:
          description: >-
            ReferenceMonth é o RÓTULO da fatura — "04/2026" é a fatura de abril,
            a

            que VENCE em abril (Decisão D4), não a que fecha em abril.
          type: string
        rolled_amount:
          type: number
        total:
          type: string
        total_value:
          type: number
      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

````