Skip to content
API/
Financeiro
/
/v1

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)

Operations

Retornar os centros de custo por filtro

Request

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 financeiros e facilitar análise orçamentária.

Security
BearerAuth
Query
paginanumberrequired

Página

Example:pagina=1
tamanho_paginanumberrequired

Tamanho da página

Enum:1020501002005001000
Example:tamanho_pagina=10
buscastring

Busca textual por nome ou código

Example:busca=010
filtro_rapidostring

Filtro rápido para itens ativos, inativos ou todos

Enum:"ATIVO""INATIVO""TODOS"
Example:filtro_rapido=ATIVO
campo_ordenado_ascendentestring

Campo para ordenação ascendente. Se informado ele desconsidera o valor do campo_ordenado_descendente. É possível ordenar por nome ou por código

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 nome ou por código

Example:campo_ordenado_descendente=nome
curl -i -X GET \
  'https://api-v2.contaazul.com/v1/centro-de-custo?pagina=1&tamanho_pagina=10&busca=010&filtro_rapido=ATIVO&campo_ordenado_ascendente=nome&campo_ordenado_descendente=nome' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

OK

Bodyapplication/json
itens_totaisinteger
Example:6
itemsArray of objects(CentroDeCusto)
totaisobject(Totais)
Response
{
  "itens_totais": 6,
  "items": [
    { … }
  ],
  "totais": {
    "ativo": 6,
    "inativo": 0,
    "todos": 6
  }
}