# v1

Conjunto de recursos para acompanhar e administrar as finanças da empresa -  esses recursos incluem centros de custo, parcelas, categorias, categorias dre,  contas financeiras e movimentações (contas a pagar e a receber)

 - [GET /v1/centro-de-custo](https://developers.contaazul.com/docs/financial-apis-openapi/v1/searchcostcenters.md): Permite consultar os centros de custo cadastrados. Suporta filtros como página, tamanho de página, busca por texto, status (ativo/inativo/todos) e ordenação. Utilizado para consultar lançamentos finan
 - [POST /v1/centro-de-custo](https://developers.contaazul.com/docs/financial-apis-openapi/v1/createcostcenter.md): Permite criar um novo centro de custo, definindo campos como código, nome, parâmetros que ajudam a organizar os custos da empresa de forma estruturada.
 - [GET /v1/financeiro/eventos-financeiros/{id_evento}/parcelas](https://developers.contaazul.com/docs/financial-apis-openapi/v1/getinstallmentsbyeventid.md): Permite listar as parcelas vinculadas a um evento financeiro específico (id_evento). Útil para acompanhar cada parcela de um lançamento de contas a pagar ou receber, com seus valores, vencimentos e st
 - [GET /v1/categorias](https://developers.contaazul.com/docs/financial-apis-openapi/v1/searchcategories.md): Permite listar as categorias utilizadas para classificação de receitas ou despesas. Auxilia no controle, agrupamento e geração de relatórios financeiros baseados em categorias.
 - [GET /v1/categorias/configuracao-padrao](https://developers.contaazul.com/docs/financial-apis-openapi/v1/getdefaultcategoryconfig.md): Retorna o de-para entre as operações financeiras e as categorias configuradas para o tenant, incluindo opcionalmente a sugestão padrão de categoria para cada operação.
 - [GET /v1/financeiro/categorias-dre](https://developers.contaazul.com/docs/financial-apis-openapi/v1/searchdrecategories.md): Permite listar as categorias de DRE (Demonstração do Resultado do Exercício) usadas para a estrutura contábil-financeira da empresa, facilitando o fechamento financeiro e contábil.
 - [GET /v1/conta-financeira](https://developers.contaazul.com/docs/financial-apis-openapi/v1/searchfinancialaccounts.md): Permite consultar as contas financeiras existentes no sistema (contas bancárias, cartões, poupança, etc.). Suporta filtros como tipo de conta, nome, se estão ativas, entre outros.
 - [GET /v1/conta-financeira/{id_conta_financeira}/saldo-atual](https://developers.contaazul.com/docs/financial-apis-openapi/v1/searchbalancebyfinancialaccountid.md): Permite obter o saldo atual de uma conta financeira específica identificada por id_conta_financeira. Útil para monitoramento em tempo real de saldos das contas da empresa.
 - [GET /v1/financeiro/transferencias](https://developers.contaazul.com/docs/financial-apis-openapi/v1/searchaccountingexporttransfers.md): Permite consultar as transferências realizadas entre contas financeiras mediante filtros como período de datas e contas financeiras específicas. Para viabilizar a conciliação financeira automática e s
 - [POST /v1/financeiro/contas-a-receber](https://developers.contaazul.com/docs/financial-apis-openapi/v1/createreceivable.md): Permite criar um novo evento financeiro de contas a receber, passando dados como data de competência, valor, descrição, cliente, conta financeira, rateio e condições de pagamento. Facilita o registro
 - [POST /v1/financeiro/eventos-financeiros/contas-a-receber](https://developers.contaazul.com/docs/financial-apis-openapi/v1/createreceivablefinancialevent.md): > **Retorno com protocolo descontinuado em 18/10/2026.** A partir dessa data esta rota deixa de retornar `202` com protocolo e passa a responder igual ao `POST /v1/financeiro/contas-a-receber`: `201`
 - [GET /v1/financeiro/eventos-financeiros/contas-a-receber/buscar](https://developers.contaazul.com/docs/financial-apis-openapi/v1/searchinstallmentstoreceivebyfilter.md): Permite consultar as parcelas de receitas (contas a receber) mediante filtros como data de vencimento, data de competência, data de pagamento, data de alteração, valor, status, dentre outros. Essa fun
 - [POST /v1/financeiro/contas-a-pagar](https://developers.contaazul.com/docs/financial-apis-openapi/v1/createpayable.md): Permite criar um novo evento financeiro de contas a pagar, informando dados como valor, fornecedor, condições de pagamento, descrição, conta financeira e rateio. Esse endpoint facilita o registro das
 - [POST /v1/financeiro/eventos-financeiros/contas-a-pagar](https://developers.contaazul.com/docs/financial-apis-openapi/v1/createpayablefinancialevent.md): > **Retorno com protocolo descontinuado em 18/10/2026.** A partir dessa data esta rota deixa de retornar `202` com protocolo e passa a responder igual ao `POST /v1/financeiro/contas-a-pagar`: `201` co
 - [GET /v1/financeiro/eventos-financeiros/contas-a-pagar/buscar](https://developers.contaazul.com/docs/financial-apis-openapi/v1/searchinstallmentstopaybyfilter.md): Permite consultar as parcelas de despesas (contas a pagar) conforme filtros como data de vencimento, data competência, data de alteração, valor, status, conta financeira, etc. Essa consulta possibilit
 - [GET /v1/financeiro/eventos-financeiros/parcelas/{id}](https://developers.contaazul.com/docs/financial-apis-openapi/v1/getinstallmentbyid.md): Permite consultar os detalhes de uma parcela específica (de conta a receber ou a pagar) identificada pelo seu id. A resposta traz campos como data de vencimento, valor, status, conta financeira, entre
 - [PATCH /v1/financeiro/eventos-financeiros/parcelas/{id}](https://developers.contaazul.com/docs/financial-apis-openapi/v1/updateinstallment.md): Permite atualizar parcialmente uma parcela existente identificada pelo id, alterando campos como data de vencimento, valor, observações, conta financeira e outros campos permitidos. Essa operação ajud
 - [GET /v1/financeiro/eventos-financeiros/alteracoes](https://developers.contaazul.com/docs/financial-apis-openapi/v1/getalteredfinancialevents.md): Permite consultar os IDs dos eventos financeiros (contas a pagar e a receber) que foram alterados em um período definido por data de ínico e fim. Essa funcionalidade é útil para identificar quais eve
 - [GET /v1/financeiro/eventos-financeiros/saldo-inicial](https://developers.contaazul.com/docs/financial-apis-openapi/v1/getinitialbalancesoffinancialaccounts.md): Permite consultar os saldos iniciais das contas financeiras em um período definido por data de início e fim.
