GET/nfse/consultar/periodo

List invoices by period

Returns every invoice submitted in a period for a given CPF/CNPJ, regardless of status. Limited to 25 records per call; paginate with hashProximaPagina. Query types: - cpfCnpj only — all records. - cpfCnpj + dataInicial + dataFinal — records in that window. Typical uses: - Consolidate daily or monthly issuances. - Find an invoice when you do not have the ID or idIntegracao. - List every invoice sent in a period. Notes: - Maximum interval is 31 days. - Results are sorted descending. - The filter date is the date the API received the invoice, which can differ from authorization or issuance date. - This route is cached for 300 seconds. For real-time status, query by ID or idIntegracao.

Production: https://api.otentecnologia.com.brSandbox: https://api.sandbox.otentecnologia.com.br

Parameters

cpfCnpj query · required	CPF or CNPJ of the company you want to query.
dataInicial query	Query start date.
dataFinal query	Query end date.
hashProximaPagina query	Hash of the next invoice for pagination.

Request

cURL

curl -X GET 'https://api.otentecnologia.com.br/nfse/consultar/periodo' \
  -H 'x-api-key: $OTEN_API_KEY' \
  -H 'Content-Type: application/json'

Responses

200OK

400Bad Request

JSON

{
  "error": {
    "message": "O CPF utilizado na operação é inválido",
    "data": {
      "cpf": "0"
    }
  }
}

401Unauthorized

JSON

{
  "error": {
    "message": "O token informado é inválido. Para o ambiente de produção, Acesse https://www.otentecnologia.com.br/, e gere o seu TOKEN de acesso"
  }
}