Meu Dinheiro · API
Categorias

Lista as categorias

GET
/categorias

Categorias de receita, despesa e transferência, com as subcategorias na mesma lista (categoria_pai_id aponta para a categoria de cima). Inclui as inativas, que lançamentos antigos ainda usam; filtre com status=active para ficar só com as ativas.

Autenticação

accessToken
headerAuthorizationBearer <token>

Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.

Parâmetros de consulta

limit?integer

Itens por página.

Faixa1 <= value <= 500
Padrão100
cursor?string

O next_cursor da página anterior. Omita na primeira página.

tipo?string
Valores"receita""despesa""transferencia"
status?string
Valores"active""inactive"

Corpo da resposta

Uma página de categorias.

application/json
  1. response
data*array<>
next_cursor*|

Cursor da próxima página; nulo na última.

curl -X GET "https://example.com/categorias"
{  "data": [    {      "id": 1042,      "nome": "Delivery",      "nome_completo": "Alimentação/Delivery",      "tipo": "receita",      "categoria_pai_id": 1001,      "status": "active",      "sistema": true    }  ],  "next_cursor": "string"}