--- updatedAt: 2026-05-28T19:21:10.000Z agentTools: projectIndex: https://docs.notagateway.com.br/llms.txt --- # Listar Notas Fiscais Recupera uma lista de notas fiscais por um critério de pesquisa [block:callout] { "type": "warning", "title": "Atenção", "body": "Esse endpoint está depreciado e será descontinuado no dia 05/10/2022" } [/block] **⚠️ Este endpoint foi descontinuado em 05 de outubro de 2022 e não pode mais ser utilizado.** # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "visão-geral", "version": "1" }, "servers": [ { "url": "https://api.notagateway.com.br" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "in": "header", "name": "Authorization", "x-bearer-format": "basic" } } }, "security": [ { "sec0": [] } ], "paths": { "/v1/empresas/{empresaId}/nfes": { "get": { "summary": "Listar Notas Fiscais", "description": "Recupera uma lista de notas fiscais por um critério de pesquisa\n\n [block:callout]\n{\n \"type\": \"warning\",\n \"title\": \"Atenção\",\n \"body\": \"Esse endpoint está depreciado e será descontinuado no dia 05/10/2022\"\n}\n[/block] ", "operationId": "listar-notas", "parameters": [ { "name": "empresaId", "in": "path", "description": "Identificador único da Empresa relacionada a Nota Fiscal que deseja emitir.", "schema": { "type": "string" }, "required": true }, { "name": "pageNumber", "in": "query", "description": "Número da página, sendo 0 o número da primeira página", "required": true, "schema": { "type": "string", "default": "0" } }, { "name": "pageSize", "in": "query", "description": "Total de itens a serem retornados por página. (Limite de 150 por página)", "required": true, "schema": { "type": "string", "default": "5" } }, { "name": "filter", "in": "query", "description": "Filtro para realização da pesquisa. Possíveis campos: Status. Exemplos de filtro: status eq 'Autorizada'", "required": true, "schema": { "type": "string" } }, { "name": "Accept", "in": "header", "required": true, "schema": { "type": "string", "default": "application/json" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"totalRecords\": 1,\n \"data\": [\n {\n \"id\": \"string\",\n \"tipo\": \"NFS-e\",\n \"idExterno\": \"string\",\n \"status\": \"string\",\n \"motivoStatus\": null,\n \"ambienteEmissao\": \"Homologacao\",\n \"enviadaPorEmail\": true,\n \"dataCriacao\": \"2017-09-05T12:39:48Z\",\n \"dataUltimaAlteracao\": \"2017-09-05T12:40:02Z\",\n \"cliente\": {\n \"tipoPessoa\": \"F\",\n \"nome\": \"string\",\n \"email\": \"string\",\n \"cpfCnpj\": \"string\",\n \"inscricaoMunicipal\": null,\n \"telefone\": null,\n \"endereco\": {\n \"uf\": \"string\",\n \"cidade\": \"string\",\n \"logradouro\": \"string\",\n \"numero\": \"string\",\n \"complemento\": null,\n \"bairro\": \"string\",\n \"cep\": \"string\"\n }\n },\n \"numero\": \"string\",\n \"codigoVerificacao\": \"string\",\n \"chaveAcesso\": null,\n \"dataAutorizacao\": \"2017-09-05T12:39:55Z\",\n \"linkDownloadPDF\": \"string\",\n \"linkDownloadXML\": \"string\",\n \"numeroRps\": 0,\n \"serieRps\": \"string\",\n \"dataCompetenciaRps\": \"2017-09-05T12:39:48Z\",\n \"servico\": {\n \"descricao\": \"string\",\n \"aliquotaIss\": 0,\n \"issRetidoFonte\": false,\n \"codigoServicoMunicipio\": \"string\",\n \"itemListaServicoLC116\": \"string\",\n \"cnae\": null,\n \"municipioPrestacaoServico\": 0\n },\n \"naturezaOperacao\": \"string\",\n \"valorCofins\": 0,\n \"valorCsll\": 0,\n \"valorInss\": 0,\n \"valorIr\": 0,\n \"valorPis\": 0,\n \"valorTotal\": 1,\n \"observacoes\": null\n }\n ]\n}" } }, "schema": { "type": "object", "properties": { "totalRecords": { "type": "integer", "example": 1, "default": 0 }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "example": "string" }, "tipo": { "type": "string", "example": "NFS-e" }, "idExterno": { "type": "string", "example": "string" }, "status": { "type": "string", "example": "string" }, "motivoStatus": {}, "ambienteEmissao": { "type": "string", "example": "Homologacao" }, "enviadaPorEmail": { "type": "boolean", "example": true, "default": true }, "dataCriacao": { "type": "string", "example": "2017-09-05T12:39:48Z" }, "dataUltimaAlteracao": { "type": "string", "example": "2017-09-05T12:40:02Z" }, "cliente": { "type": "object", "properties": { "tipoPessoa": { "type": "string", "example": "F" }, "nome": { "type": "string", "example": "string" }, "email": { "type": "string", "example": "string" }, "cpfCnpj": { "type": "string", "example": "string" }, "inscricaoMunicipal": {}, "telefone": {}, "endereco": { "type": "object", "properties": { "uf": { "type": "string", "example": "string" }, "cidade": { "type": "string", "example": "string" }, "logradouro": { "type": "string", "example": "string" }, "numero": { "type": "string", "example": "string" }, "complemento": {}, "bairro": { "type": "string", "example": "string" }, "cep": { "type": "string", "example": "string" } } } } }, "numero": { "type": "string", "example": "string" }, "codigoVerificacao": { "type": "string", "example": "string" }, "chaveAcesso": {}, "dataAutorizacao": { "type": "string", "example": "2017-09-05T12:39:55Z" }, "linkDownloadPDF": { "type": "string", "example": "string" }, "linkDownloadXML": { "type": "string", "example": "string" }, "numeroRps": { "type": "integer", "example": 0, "default": 0 }, "serieRps": { "type": "string", "example": "string" }, "dataCompetenciaRps": { "type": "string", "example": "2017-09-05T12:39:48Z" }, "servico": { "type": "object", "properties": { "descricao": { "type": "string", "example": "string" }, "aliquotaIss": { "type": "integer", "example": 0, "default": 0 }, "issRetidoFonte": { "type": "boolean", "example": false, "default": true }, "codigoServicoMunicipio": { "type": "string", "example": "string" }, "itemListaServicoLC116": { "type": "string", "example": "string" }, "cnae": {}, "municipioPrestacaoServico": { "type": "integer", "example": 0, "default": 0 } } }, "naturezaOperacao": { "type": "string", "example": "string" }, "valorCofins": { "type": "integer", "example": 0, "default": 0 }, "valorCsll": { "type": "integer", "example": 0, "default": 0 }, "valorInss": { "type": "integer", "example": 0, "default": 0 }, "valorIr": { "type": "integer", "example": 0, "default": 0 }, "valorPis": { "type": "integer", "example": 0, "default": 0 }, "valorTotal": { "type": "integer", "example": 1, "default": 0 }, "observacoes": {} } } } } } } } }, "400": { "description": "400", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"Message\": \"The request is invalid.\"\n}" } }, "schema": { "type": "object", "properties": { "Message": { "type": "string", "example": "The request is invalid." } } } } } }, "401": { "description": "401", "content": { "application/json": { "examples": { "Result": { "value": "[\n {\n \"codigo\": \"AUT002\",\n \"mensagem\": \"Acesso negado. APIKey invalida, por favor verifique se setou o header do request corretamente com uma APIKey válida, por exemplo: \\\"Authorization: Basic {your-APIKey-here}\\\".\"\n }\n]" } }, "schema": { "type": "array", "items": { "type": "object", "properties": { "codigo": { "type": "string", "example": "AUT002" }, "mensagem": { "type": "string", "example": "Acesso negado. APIKey invalida, por favor verifique se setou o header do request corretamente com uma APIKey válida, por exemplo: \"Authorization: Basic {your-APIKey-here}\"." } } } } } } }, "403": { "description": "403", "content": { "application/json": { "examples": { "Result": { "value": "[\n {\n \"codigo\": \"AUT001\",\n \"mensagem\": \"Acesso negado. APIKey invalida, por favor verifique se ela está correta.\"\n }\n]" } }, "schema": { "type": "array", "items": { "type": "object", "properties": { "codigo": { "type": "string", "example": "AUT001" }, "mensagem": { "type": "string", "example": "Acesso negado. APIKey invalida, por favor verifique se ela está correta." } } } } } } }, "500": { "description": "500", "content": { "text/plain": { "examples": { "Result": { "value": "Erro interno do servidor" } } } } } }, "deprecated": false, "x-readme": { "code-samples": [ { "language": "csharp", "code": "public string ConsultarNFsAsync(Guid empresaId, int pageNumber, int pageSize, string filter, string sortBy = \"\", string sortDirection = \"\")\n{\n try\n {\n var parameters = new StringBuilder(string.Format(\"https://api.enotasgw.com.br/v1/empresas/{0}/nfes?pageNumber={1}&pageSize={2}&filter={3}\", empresaId, pageNumber.ToString(), pageSize.ToString(), filter));\n\n if (!string.IsNullOrEmpty(sortBy))\n parameters.Append(\"&sortBy=\" + sortBy);\n\n if (!string.IsNullOrEmpty(sortDirection))\n parameters.Append(\"&sortDirection=\" + sortDirection);\n\n using (var httpClient = new HttpClient())\n {\n httpClient.DefaultRequestHeaders.Clear();\n httpClient.DefaultRequestHeaders.Add(\"Authorization\", \"Basic {Sua-ApiKey-Aqui}\");\n httpClient.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue(\"application/json\"));\n\n using (var request = new HttpRequestMessage(HttpMethod.Get, parameters.ToString()))\n {\n using (var response = httpClient.SendAsync(request).Result)\n {\n var resultContent = response.Content.ReadAsStringAsync().Result;\n\n if (response.IsSuccessStatusCode)\n {\n return resultContent;\n }\n else\n {\n throw new Exception(((int)response.StatusCode) + \" - \" + response.ReasonPhrase);\n }\n }\n }\n }\n }\n catch (Exception)\n {\n throw;\n }\n}", "name": "Exemplo C#" } ], "samples-languages": [ "csharp" ] } } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```