---
title: "Lista documentos fiscais do comprador com base em critérios como datas, status, venda e conteúdo, detalhando informações fiscais e do cliente."
method: GET
path: "/myeduzz/v1/financial/buyer/fiscal-documents"
tags: ["MyEduzz"]
---

# Lista documentos fiscais do comprador com base em critérios como datas, status, venda e conteúdo, detalhando informações fiscais e do cliente.

`GET /myeduzz/v1/financial/buyer/fiscal-documents`

## Request

- Base URL: `https://api.eduzz.com`
- URL: `https://api.eduzz.com/myeduzz/v1/financial/buyer/fiscal-documents`
- Auth: OAuth 2
  - Implicit: `https://accounts.eduzz.com/oauth/authorize`
  - Scopes: `myeduzz_financial_read`
- TypeScript: <https://skmtc.dev/eduzz/apis/eduzz-public-api/docs/myeduzz/v1/financial/buyer/fiscal-documents/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `page` number: Página atual
- `itemsPerPage` number: Número de itens por página
- `startDate` string, date-time, required: Data de início
- `endDate` string, date-time, required: Data de término
- `status` 'new' | 'pending' | 'waitingDocument' | 'canceled' | 'processed' | 'approved' | 'fileGenerated' | 'processing' | 'deleted': Status do documento fiscal
- `name` string: Nome do cliente
- `email` string: Email do cliente
- `saleId` string: Id da venda
- `productId` string: Id do produto
- `documentId` string: Id do documento

## Response `200`

Listagem de Documentos Fiscais

- object
  - `pages` number, required: Número de páginas
  - `page` number, required: Página atual
  - `itemsPerPage` number, required: Número máximo de itens por página
  - `totalItems` number, required: Número total de itens
  - `items` object[], required: Itens dos documentos fiscais
    - `document` object, required: Informações do documento fiscal
      - `id` string, required: Id do documento fiscal
      - `name` string, required: Nome do documento fiscal
      - `status` string, required: Status do documento fiscal
      - `type` string, required: Tipo do documento fiscal
      - `baseValue` object, required: Valor base do documento fiscal
        - `currency` string, required: Moeda
        - `value` number, required: Valor
      - `emissionDate` string, date-time, required: Data de emissão do documento fiscal
      - `referenceDate` string, date-time, required: Data de referência do documento fiscal
      - `processingDate` string, date-time, required: Data de processamento do documento fiscal
      - `taxation` object, required: Informações de tributação do documento fiscal
        - `nbs` object, required: NBS (Nomenclatura Brasileira de Serviços)
          - `code` string, required: Código NBS
          - `description` string, required: Descrição do código NBS
        - `taxClassification` object, required: Classificação tributária
          - `code` string, required: Código de classificação tributária
          - `description` string, required: Descrição do código de classificação tributária
        - `operationIndicator` object, required: Indicador de operação
          - `code` string, required: Código de indicador de operação
          - `description` string, required: Descrição do código de indicador de operação
    - `source` object, required: Informações da fonte
      - `taxType` string, nullable, required: Tipo de imposto da fonte
      - `companyName` string, required: Nome da empresa de origem
      - `document` string, required: Documento da fonte
      - `ie` string, required: Inscrição estadual da fonte
      - `im` string, nullable, required: Inscrição municipal da fonte
      - `email` string, required: Email da fonte
      - `tel` string, nullable, required: Telefone da fonte
      - `tel2` string, required: Telefone 2 da fonte
      - `cell` string, nullable, required: Celular da fonte
      - `address` object, required: Informações de endereço da fonte
        - `street` string, required: Rua da fonte
        - `number` string, required: Número da rua da fonte
        - `complement` string, required: Complemento da fonte
        - `district` string, required: Bairro da fonte
        - `zipCode` string, required: CEP da fonte
        - `city` string, required: Cidade da fonte
        - `uf` string, required: UF da fonte
    - `destination` object, required: Informações do destino
      - `companyName` string, required: Nome da empresa de destino
      - `taxType` string, required: Tipo de imposto do destino
      - `taxId` string, required: Id do imposto do destino
      - `ie` string, required: Inscrição estadual do destino
      - `im` string, nullable, required: Inscrição municipal do destino
      - `email` string, required: Email do destino
      - `tel` string, nullable, required: Telefone do destino
      - `tel2` string, nullable, required: Telefone 2 do destino
      - `cell` string, required: Celular do destino
      - `address` object, required: Informações de endereço do destino
        - `street` string, nullable, required: Rua do destino
        - `number` string, nullable, required: Número da rua do destino
        - `complement` string, nullable, required: Complemento do destino
        - `district` string, nullable, required: Bairro do destino
        - `zipCode` string, required: CEP do destino
        - `countryForeign` string, nullable, required: País estrangeiro do destino
        - `city` string, nullable, required: Cidade do destino
        - `uf` string, nullable, required: UF do destino
        - `country` string, nullable, required: País do destino
    - `sale` object, required: Informações da venda
      - `id` string, required: Id da venda
      - `paymentDate` string, date-time, required: Data do pagamento
      - `total` object, required: Total da Venda
        - `currency` string, required: Moeda
        - `value` number, required: Valor
    - `client` object, required: Informações do cliente
      - `id` string, required: Id do cliente
      - `name` string, required: Nome do cliente
      - `document` string, required: Documento do cliente
      - `email` string, required: Email do cliente
      - `telephone` string, nullable, required: Telefone do cliente
      - `telephone2` string, nullable, required: Telefone 2 do cliente
      - `cellphone` string, required: Celular do cliente
      - `address` object, required: Informações de endereço do cliente
        - `street` string, nullable, required: Rua do cliente
        - `number` string, nullable, required: Número do endereço do cliente
        - `complement` string, nullable, required: Complemento do endereço do cliente
        - `neighborhood` string, nullable, required: Bairro do cliente
        - `zipCode` string, required: CEP do cliente
        - `city` string, nullable, required: Cidade do cliente
        - `state` string, nullable, required: Estado do cliente
    - `product` object, required: Informações do produto
      - `id` string, required: Id do produto
      - `title` string, required: Título do produto
    - `generatedByNewSystem` boolean, required: Gerado pelo novo sistema

## Changes

- **2026-10-26** `f93320e6a417`: 8 info
  - the `query` request parameter `documentId` became optional
  - the `query` request parameter `email` became optional
  - the `query` request parameter `itemsPerPage` became optional
  - the `query` request parameter `name` became optional
  - …4 more
- **2026-10-10** `8e41c62b53a8`: 17 breaking, 9 info
  - the `query` request parameter `status` was restricted to a list of enum values
  - the `query` request parameter `documentId` became required
  - the `query` request parameter `email` became required
  - the `query` request parameter `endDate` became required
  - …22 more
- **2026-04-19** `5abec7e14710`: 10 warning, 10 info
  - deleted the `query` request parameter `0`
  - deleted the `query` request parameter `1`
  - deleted the `query` request parameter `2`
  - deleted the `query` request parameter `3`
  - …16 more
- **2025-05-18** `a47e6171d83d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/eduzz/apis/eduzz-public-api/changes/myeduzz/v1/financial/buyer/fiscal-documents/get.md)

---

[API](https://skmtc.dev/eduzz/apis/eduzz-public-api.md) - [All operations](https://skmtc.dev/eduzz/apis/eduzz-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/eduzz/apis/eduzz-public-api/revisions/5d05c72e5bf5?raw)
