/invoices
As notas do ambiente da chave, as mais novas primeiro.
https://cronota.clowk.in/api/v1/invoicesAutorização
Bearer token: sk_live_… (Live) ou sk_test_… (Sandbox). A chave define a empresa e o ambiente.
Parâmetros
statusstring · queryopcionalAtalho: um status ou vários separados por vírgula, como authorized,cancelled.
competencestring · queryopcionalAtalho: o mês de competência inteiro, AAAA-MM.
customer_idstring · queryopcionalAtalho: só as notas deste tomador.
qobject · queryopcionalFiltros em q[campo_predicado]. Campos: status, source, nfse_number, access_key, amount_cents, competence, issued_at, cancelled_at, substituted_at, created_at, updated_at, customer_id, invoice_template_id, schedule_id, replaces_invoice_id e, do tomador, customer_document, customer_name, customer_email. Exemplos: q[status_in][]=authorized, q[amount_cents_gteq]=10000, q[issued_at_gteq]=2026-11-01, q[customer_document_start]=112223.
sortstring · queryopcionalUm campo, ou -campo para decrescente; vários com vírgula. Padrão -created_at.
pageinteger · queryopcionalA página, a partir de 1. A resposta diz total e has_more.
limitinteger · queryopcionalItens por página, de 1 a 100.
Respostas
200A lista.
objectstringopcionaldataobject[]opcionalidstringopcionalobjectstringopcionallivemodebooleanopcionalstatusstringopcionalamountstringopcionalcompetencestringopcionaldescriptionstringopcionalcustomer_idstring | nullopcionaltemplate_idstring | nullopcionalnfse_numberstring | nullopcionalaccess_keystring | nullopcionalA chave de acesso de 50 dígitos.
dpsobject | nullopcionalseriesstringopcionalnumberintegeropcionalpdf_readybooleanopcionalerrorsobject[]opcionalOs erros do Sefin, numa nota rejeitada.
codestringopcionalmessagestringopcionalsefin_codestringopcionalissued_atstring | nullopcionalcancelled_atstring | nullopcionalreplaces_invoice_idstring | nullopcionalA nota que esta substitui.
substituted_atstring | nullopcionalpublic_urlstring | nullopcionalO link público da nota (PDF e XML, sem login), válido por 7 dias. Só em notas da API e de integrações.
public_url_expires_atstring | nullopcionalcreated_atstringopcionalpageintegeropcionallimitintegeropcionaltotalintegeropcionalQuantos itens os filtros acham, em todas as páginas.
has_morebooleanopcionalHá uma próxima página.
401Chave ausente, errada, revogada ou vencida.
errorobjectopcionalcodestringopcionalEstável, para o seu código decidir.
messagestringopcionalPara pessoas, em português.
fieldsobjectopcionalNos 422 de validação: as mensagens de cada campo, com os nomes que a API recebe (como address.street).