Retornar as despesas por filtro

Request

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 possibilita monitorar as obrigações financeiras pendentes ou pagas, favorecendo a gestão e o planejamento.

Security

BearerAuth

Query

paginainteger, >= 1required

Página

Default:1

Example:pagina=1

tamanho_paginainteger, >= 1required

Tamanho da página

Enum:1020501002005001000

Example:tamanho_pagina=10

campo_ordenado_ascendentestring

Campo para ordenação ascendente. Se informado ele desconsidera o valor do campo_ordenado_descendente. É possível ordenar por id do centro de custo (id), pelo código (CODIGO), pelo nome (NOME) e por ativo (ATIVO)

Enum:"ID""CODIGO""NOME""ATIVO"

Example:campo_ordenado_ascendente=nome

campo_ordenado_descendentestring

Campo para ordenação descendente. Se este campo for utilizado, o campo campo_ordenado_ascendente não deverá ser informado. É possível ordenar por id do centro de custo (id), pelo código (CODIGO), pelo nome (NOME) ou por ativo (ATIVO)

Enum:"ID""CODIGO""NOME""ATIVO"

Example:campo_ordenado_descendente=nome

descricaostring

Descrição da conta

Example:descricao=Pagamento do salário

data_vencimento_destring, (date)required

Date de vencimento de (ISO date format)

Example:data_vencimento_de=2027-08-15

data_vencimento_atestring, (date)required

Data de vencimento até (ISO date format)

Example:data_vencimento_ate=2027-08-20

data_competencia_destring, (date)

Data de competência de (ISO date format)

Example:data_competencia_de=2025-08-15

data_competencia_atestring, (date)

Data de competência até (ISO date format)

Example:data_competencia_ate=2025-08-20

data_pagamento_destring, (date)

Data de pagamento de (ISO date format)

Example:data_pagamento_de=2025-08-15

data_pagamento_atestring, (date)

Data de pagamento até (ISO date format)

Example:data_pagamento_ate=2025-08-20

data_alteracao_destring, (date-time)

Data de alteração de (ISO 8601, São Paulo/GMT-3)

Example:data_alteracao_de=2025-10-20T07:00:00

data_alteracao_atestring, (date-time)

Data de alteração até (ISO 8601, São Paulo/GMT-3)

Example:data_alteracao_ate=2025-10-20T07:59:59

valor_destring^[0-9]+(\.[0-9]{1,2})?$

Valor de

Example:valor_de=100

valor_atestring^[0-9]+(\.[0-9]{1,2})?$

Valor até

Example:valor_ate=500

statusArray of strings

Lista de status da conta

Items Enum:"PERDIDO""RECEBIDO""EM_ABERTO""RENEGOCIADO""RECEBIDO_PARCIAL""ATRASADO"

Example:status=ATRASADO

ids_contas_financeirasArray of strings

Lista de IDs de contas financeiras

Example:ids_contas_financeiras=35473eec-4e74-11ee-b500-9f61de8a8b8b

ids_categoriasArray of strings

Lista de IDs de categorias

Example:ids_categorias=35473eec-4e74-11ee-b500-9f61de8a8b8b

ids_centros_de_custoArray of strings

Lista de IDs de centros de custo

Example:ids_centros_de_custo=35473eec-4e74-11ee-b500-9f61de8a8b8b

curl -i -X GET \
  'https://api-v2.contaazul.com/v1/financeiro/eventos-financeiros/contas-a-pagar/buscar?pagina=1&tamanho_pagina=10&campo_ordenado_ascendente=nome&campo_ordenado_descendente=nome&descricao=Pagamento%20do%20sal%C3%A1rio&data_vencimento_de=2027-08-15&data_vencimento_ate=2027-08-20&data_competencia_de=2025-08-15&data_competencia_ate=2025-08-20&data_pagamento_de=2025-08-15&data_pagamento_ate=2025-08-20&data_alteracao_de=2025-10-20T07%3A00%3A00&data_alteracao_ate=2025-10-20T07%3A59%3A59&valor_de=100&valor_ate=500&status=ATRASADO&ids_contas_financeiras=35473eec-4e74-11ee-b500-9f61de8a8b8b&ids_categorias=35473eec-4e74-11ee-b500-9f61de8a8b8b&ids_centros_de_custo=35473eec-4e74-11ee-b500-9f61de8a8b8b' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Bodyapplication/json

itens_totaisinteger

Example:6

itensArray of objects(ContaAPagar)

totaisobject

Response

{
  "itens_totais": 6,
  "itens": [
    { … }
  ],
  "totais": {
    "ativo": 6,
    "inativo": 0,
    "todos": 6
  }
}