---
title: "Listar NFe´s."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-Nfe-Listar/get"
---

> Full API specification: https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050.md

# Listar NFe´s.

`GET` `/api/v1/Nfe/Listar`

Fornece uma listagem detalhada das <strong>Notas Fiscais Eletrônicas (NFe)</strong> emitidas ou processadas pelo Emissor. 🔍 **CAPACIDADE DE BUSCA**: O recurso suporta filtros complexos que permitem a extração de relatórios e a reconciliação fiscal. O campo `busca` realiza uma varredura genérica em múltiplos campos (número, série, chave e participantes). 📑 **PAGINAÇÃO**: A API utiliza o modelo de <strong>offset</strong> e <strong>limit</strong>. Recomendamos o uso de limites baixos (ex: 50 registros) para garantir a performance da resposta e economia de banda. ⚖️ **CONTEXTO FISCAL**: Os resultados refletem o estado atual dos documentos na base da Stone Tax, permitindo filtrar por status específicos (Autorizada, Cancelada, Rejeitada, etc.) e intervalos de valores ou datas.

## Query parameters

- `notaFiscalId` (string, uuid, optional) - Filtrar pelo identificador único da nota fiscal no sistema.
- `codigoErp` (string, optional) - Filtrar pelo código ERP.
- `busca` (string, optional) - Filtrar pelo termo de busca genérica.
- `inscricaoEstadualEmissor` (string, optional) - Filtrar pela inscrição estadual do emissor do documento.
- `numeroDocumento` (string, optional) - Filtrar pelo número sequencial do documento fiscal.
- `serie` (string, optional) - Filtrar pela série do documento fiscal.
- `chaveAcesso` (array, optional) - Filtrar pel lista de chaves de acesso (44 dígitos).
- `documentoParticipante` (string, optional) - Filtrar pelo documento (CPF/CNPJ) do participante.
- `nomeParticipante` (string, optional) - Filtrar pel nome ou razão social do participante.
- `dataEmissaoInicial` (string, date-time, optional) - Filtrar documentos emitidos a partir desta data.
- `dataEmissaoFinal` (string, date-time, optional) - Filtrar documentos emitidos até esta data.
- `dataCancelamentoInicial` (string, date-time, optional) - Filtrar documentos cancelados a partir desta data.
- `dataCancelamentoFinal` (string, date-time, optional) - Filtrar documentos cancelados até esta data.
- `valorDocumentoInicial` (number, double, optional) - Filtrar pelo valor mínimo do documento.
- `valorDocumentoFinal` (number, double, optional) - Filtrar pel valor máximo do documento.
- `status` (string, optional) - Filtrar pelo status atual da nota fiscal.
- `consumidorFinal` (boolean, optional) - Filtrar pelo indicador do documento emitido para consumidor final.
- `documentoTransportador` (string, optional) - Filtrar pelo documento (CPF/CNPJ) da transportadora.
- `nomeTransportador` (string, optional) - Filtrar pelo nome ou razão Social da transportadora.
- `modalidadeFrete` (string, optional) - Filtrar pela modalidade do frete.
- `documentoIntermediador` (string, optional) - Filtrar pelo documento (CPF/CNPJ) do intermediador.
- `identificadorIntermediador` (string, optional) - Filtrar pelo identificador do intermediador na plataforma.
- `modoContingenciaOffline` (boolean, optional) - Filtrar por notas que foram geradas em modo de contingência offline, ou seja, sem comunicação com a SEFAZ no momento da emissão.
- `ordenarPor` (string, optional) - Campo pelo qual a listagem será ordenada. Padrão: DataEmissao.
- `ordemDecrescente` (boolean, optional) - Define se a ordenação é decrescente. Padrão: true.
- `offset` (integer, int32, optional) - Paginação da listagem - offset.
- `limit` (integer, int32, optional) - Paginação da listagem - limit.

## Header parameters

- `DocumentoEmissor` (string, required) - Documento do emissor.

## Responses

- `200` - OK
- `400` - Bad Request
- `401` - Unauthorized
- `403` - Forbidden
- `500` - Internal Server Error

## OpenAPI definition

```yaml
openapi: 3.0.4
info:
  title: Stone Tax API
  version: 1.0.0
servers:
  - url: https://stone-tax-sdx.stone.com.br
    description: Ambiente de Desenvolvimento
  - url: https://stone-tax.stone.com.br
    description: Ambiente de Produção
paths:
  /api/v1/Nfe/Listar:
    get:
      tags:
        - Nfe
      summary: Listar NFe´s.
      description: >-
        Fornece uma listagem detalhada das <strong>Notas Fiscais Eletrônicas
        (NFe)</strong> emitidas ou processadas pelo Emissor. 


        🔍 **CAPACIDADE DE BUSCA**: O recurso suporta filtros complexos que
        permitem a extração de relatórios e a reconciliação fiscal. O campo
        `busca` realiza uma varredura genérica em múltiplos campos (número,
        série, chave e participantes).


        📑 **PAGINAÇÃO**: A API utiliza o modelo de <strong>offset</strong> e
        <strong>limit</strong>. Recomendamos o uso de limites baixos (ex: 50
        registros) para garantir a performance da resposta e economia de banda.


        ⚖️ **CONTEXTO FISCAL**: Os resultados refletem o estado atual dos
        documentos na base da Stone Tax, permitindo filtrar por status
        específicos (Autorizada, Cancelada, Rejeitada, etc.) e intervalos de
        valores ou datas.
      parameters:
        - name: notaFiscalId
          in: query
          description: Filtrar pelo identificador único da nota fiscal no sistema.
          schema:
            type: string
            format: uuid
        - name: codigoErp
          in: query
          description: Filtrar pelo código ERP.
          schema:
            type: string
        - name: busca
          in: query
          description: Filtrar pelo termo de busca genérica.
          schema:
            type: string
        - name: inscricaoEstadualEmissor
          in: query
          description: Filtrar pela inscrição estadual do emissor do documento.
          schema:
            type: string
        - name: numeroDocumento
          in: query
          description: Filtrar pelo número sequencial do documento fiscal.
          schema:
            type: string
        - name: serie
          in: query
          description: Filtrar pela série do documento fiscal.
          schema:
            type: string
        - name: chaveAcesso
          in: query
          description: Filtrar pel lista de chaves de acesso (44 dígitos).
          schema:
            type: array
            items:
              type: string
        - name: documentoParticipante
          in: query
          description: Filtrar pelo documento (CPF/CNPJ) do participante.
          schema:
            type: string
        - name: nomeParticipante
          in: query
          description: Filtrar pel nome ou razão social do participante.
          schema:
            type: string
        - name: dataEmissaoInicial
          in: query
          description: Filtrar documentos emitidos a partir desta data.
          schema:
            type: string
            format: date-time
        - name: dataEmissaoFinal
          in: query
          description: Filtrar documentos emitidos até esta data.
          schema:
            type: string
            format: date-time
        - name: dataCancelamentoInicial
          in: query
          description: Filtrar documentos cancelados a partir desta data.
          schema:
            type: string
            format: date-time
        - name: dataCancelamentoFinal
          in: query
          description: Filtrar documentos cancelados até esta data.
          schema:
            type: string
            format: date-time
        - name: valorDocumentoInicial
          in: query
          description: Filtrar pelo valor mínimo do documento.
          schema:
            type: number
            format: double
        - name: valorDocumentoFinal
          in: query
          description: Filtrar pel valor máximo do documento.
          schema:
            type: number
            format: double
        - name: status
          in: query
          description: Filtrar pelo status atual da nota fiscal.
          schema:
            $ref: "#/components/schemas/StatusNotaFiscalModelEnum"
        - name: consumidorFinal
          in: query
          description: Filtrar pelo indicador do documento emitido para consumidor final.
          schema:
            type: boolean
        - name: documentoTransportador
          in: query
          description: Filtrar pelo documento (CPF/CNPJ) da transportadora.
          schema:
            type: string
        - name: nomeTransportador
          in: query
          description: Filtrar pelo nome ou razão Social da transportadora.
          schema:
            type: string
        - name: modalidadeFrete
          in: query
          description: Filtrar pela modalidade do frete.
          schema:
            $ref: "#/components/schemas/ModalidadeFreteNotaFiscalModelEnum"
        - name: documentoIntermediador
          in: query
          description: Filtrar pelo documento (CPF/CNPJ) do intermediador.
          schema:
            type: string
        - name: identificadorIntermediador
          in: query
          description: Filtrar pelo identificador do intermediador na plataforma.
          schema:
            type: string
        - name: modoContingenciaOffline
          in: query
          description: Filtrar por notas que foram geradas em modo de contingência
            offline, ou seja, sem comunicação com a SEFAZ no momento da emissão.
          schema:
            type: boolean
        - name: ordenarPor
          in: query
          description: "Campo pelo qual a listagem será ordenada. Padrão: DataEmissao."
          schema:
            $ref: "#/components/schemas/OrdenacaoListarNotasFiscaisModelEnum"
        - name: ordemDecrescente
          in: query
          description: "Define se a ordenação é decrescente. Padrão: true."
          schema:
            type: boolean
            default: true
        - name: offset
          in: query
          description: Paginação da listagem - offset.
          schema:
            type: integer
            format: int32
            default: 1
        - name: limit
          in: query
          description: Paginação da listagem - limit.
          schema:
            type: integer
            format: int32
            default: 10
        - name: DocumentoEmissor
          in: header
          description: Documento do emissor.
          required: true
          schema:
            type: string
      responses:
        "200":
          description: OK
          content:
            text/plain:
              schema:
                $ref: "#/components/schemas/ListarNotasFiscaisViewModelListPaginationResponse"
            application/json:
              schema:
                $ref: "#/components/schemas/ListarNotasFiscaisViewModelListPaginationResponse"
            text/json:
              schema:
                $ref: "#/components/schemas/ListarNotasFiscaisViewModelListPaginationResponse"
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "401":
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "403":
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "500":
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
      security:
        - BearerAuth: []
security:
  - BearerAuth: []
components:
  schemas:
    StatusNotaFiscalModelEnum:
      enum:
        - Pendente
        - Autorizada
        - Cancelada
        - Inutilizada
        - Rejeitada
        - Denegada
        - EmCancelamento
        - EmContingencia
        - Substituida
      type: string
      description: Status do documento eletrônico.
    ModalidadeFreteNotaFiscalModelEnum:
      enum:
        - Cif
        - Fob
        - FretePorContaDeTerceiros
        - TransporteProprioRemetente
        - TransporteProprioDestinatario
        - SemOcorrenciaDeTransporte
      type: string
      description: Modalidade de frete.
    OrdenacaoListarNotasFiscaisModelEnum:
      enum:
        - DataEmissao
        - SerieNumeracao
        - NomeDestinatario
      type: string
      description: Campo pelo qual a listagem de notas fiscais será ordenada.
    ListarNotasFiscaisViewModelListPaginationResponse:
      type: object
      properties:
        offset:
          type: integer
          format: int32
        limit:
          type: integer
          format: int32
        total:
          type: integer
          format: int32
        data:
          type: array
          items:
            $ref: "#/components/schemas/ListarNotasFiscaisViewModel"
          nullable: true
      additionalProperties: false
    ResponseErrorResult:
      type: object
      properties:
        status:
          type: integer
          format: int32
        titulo:
          type: string
          nullable: true
        erros:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          nullable: true
      additionalProperties: false
    ListarNotasFiscaisViewModel:
      type: object
      properties:
        id:
          type: string
          description: Identificador interno do documento fiscal.
          format: uuid
          nullable: true
        codigoErp:
          type: string
          description: Identificador da operação fiscal no ERP.
          nullable: true
        chaveAcesso:
          type: string
          description: Chave de acesso do documento fiscal.
          nullable: true
        modeloNotaFiscal:
          $ref: "#/components/schemas/ModeloNotaFiscalModelEnum"
        naturezaOperacao:
          type: string
          description: Natureza da operação.
          nullable: true
        numeroDocumento:
          type: string
          description: Numero do documento fiscal.
          nullable: true
        serie:
          type: string
          description: Série do documento fiscal.
          nullable: true
        tipoAmbiente:
          $ref: "#/components/schemas/TipoAmbienteSefazModelEnum"
        tipoOperacao:
          $ref: "#/components/schemas/TipoOperacaoNotaFiscalModelEnum"
        indicadorPresenca:
          $ref: "#/components/schemas/IndicadorPresencaNotaFiscalModelEnum"
        consumidorFinal:
          type: boolean
          description: Indica se a operação foi destinada a consumidor final ou não.
        tipoIdDestino:
          $ref: "#/components/schemas/TipoIdDestinoNotaFiscalModelEnum"
        documentoParticipante:
          type: string
          description: Documento do participante.
          nullable: true
        nomeParticipante:
          type: string
          description: Nome do participante.
          nullable: true
        valorDocumento:
          type: number
          description: Valor do documento.
          format: double
        dataEmissao:
          type: string
          description: Data de emissão do documento.
          format: date-time
        dataSaidaEntrada:
          type: string
          description: Data de saída/entrada.
          format: date-time
          nullable: true
        dataCancelamento:
          type: string
          description: Data de cancelamento do documento.
          format: date-time
          nullable: true
        status:
          $ref: "#/components/schemas/StatusNotaFiscalModelEnum"
        ultimoCstat:
          type: integer
          description: Último código de status retornado pela sefaz.
          format: int32
          nullable: true
        mensagemSefaz:
          type: string
          description: Última mensagem retornada pela sefaz.
          nullable: true
        modalidadeFrete:
          $ref: "#/components/schemas/ModalidadeFreteNotaFiscalModelEnum"
        cnpjTransportador:
          type: string
          description: CNPJ do transportador.
          nullable: true
        nomeTransportador:
          type: string
          description: Nome do transportador.
          nullable: true
        cnpjIntermediador:
          type: string
          description: CNPJ do intermediador.
          nullable: true
        identificadorIntermediador:
          type: string
          description: Identificador do intermediador.
          nullable: true
        modoEmissao:
          $ref: "#/components/schemas/ModoEmissaoNotaFiscalModelEnum"
        modoContingenciaOffline:
          type: boolean
          description: Indica se a nota fiscal foi emitida em modo de contingencia offline
            ou não.
        dataHoraEntradaContingencia:
          type: string
          description: Data e hora de entrada em contingência offline.
          format: date-time
          nullable: true
        justificativaContingencia:
          type: string
          description: Justificativa de entrada em contingência offline.
          nullable: true
      additionalProperties: false
      description: Dados de listagem de notas fiscais eletrônicas (NFe e NFCe).
    ModeloNotaFiscalModelEnum:
      enum:
        - Nfe
        - Nfce
      type: string
      description: Modelo de nota fiscal.
    TipoAmbienteSefazModelEnum:
      enum:
        - Producao
        - Homologacao
      type: string
      description: Tipo de ambiente da SEFAZ.
    TipoOperacaoNotaFiscalModelEnum:
      enum:
        - Entrada
        - Saida
      type: string
      description: Tipo de operação.
    IndicadorPresencaNotaFiscalModelEnum:
      enum:
        - NaoSeAplica
        - OperacaoPresencial
        - OperacaoNaoPresencialInternet
        - OperacaoNaoPresencialTeleatendimento
        - NfceEntregaDomicilio
        - NaoPresencialOutros
      type: string
      description: Indicador de presença na operação.
    TipoIdDestinoNotaFiscalModelEnum:
      enum:
        - OperacaoInterna
        - OperacaoInterestadual
        - OperacaoExterior
      type: string
      description: Tipo de destino da nota fiscal.
    ModoEmissaoNotaFiscalModelEnum:
      enum:
        - EmissaoCompleta
        - EmissaoSimplificada
        - EmissaoAutomatica
      type: string
      description: Modo de emissão da nota fiscal.
  securitySchemes:
    BearerAuth:
      type: http
      description: Autenticação via token JWT. Obtenha o token através do endpoint
        /Autenticacao/ObterToken usando Basic Auth. O token expira em 1 hora.
      scheme: bearer
      bearerFormat: JWT
```