Finance

List /movimentacoes

GET/api/v1/movimentacoes

Lists the account's records in two modes: page by page (limit and offset) or incremental (desde and depoisDe). Records in the recycle bin are not listed.

Key scope

Any key of the account (read is enough).

Parameters

Name	In	Type	Required	Description
`Authorization`	header	string	yes	Bearer followed by the key. Alternative: X-API-Key header.
`limit`	query	integer · default 50 · max. 200	no	Max items (up to 200). Default 50.
`offset`	query	integer · default 0	no	Offset for pagination. Default 0.
`desde`	query	string	no	Only what changed from this instant (ISO-8601: 2026-08-27 or 2026-08-27T14:30:00). Turns on incremental mode: the response carries proximoDesde/proximoId/temMais to send back on the next call.
`depoisDe`	query	integer	no	The proximoId of the previous response, together with proximoDesde in desde. Breaks ties between records saved at the same instant.

Response fields

Response envelope

Name	Type	Description
`data`	array	The records of the page.
`moeda`	string	Account functional currency (ISO 4217) of the amounts.
`limit`	integer	The limit applied.
`offset`	integer	The offset applied.
`count`	integer	How many records came in this page.
`desde`	string	Incremental mode only: the cut applied.
`temMais`	boolean	There is another page.
`proximoDesde`	string	Incremental mode only: send back as desde on the next call.
`proximoId`	integer	Incremental mode only: send back as depoisDe on the next call.

Each record in data[]

Name	Type	Description
`id`	integer	Record identifier. Use it in by-id calls.
`codigo`	integer	Record code as shown on screen.
`descricao`	string	Description.
`valor`	number	Total amount, in the currency given in moeda.
`vencimento`	string (date and time)	Due date.
`status`	string	Record status, in the screen's vocabulary.
`atualizadoEm`	string (date and time)	Incremental mode only: when the record was last created or changed.

Status codes

HTTP	Description
200	OK
401	Missing or invalid key

Error messages

HTTP	Message (erro field)	When it happens
401	`chave de API ausente ou inválida`	No key header, revoked key or typo.
401	`chave sem empresa vinculada`	The key exists but is not linked to an account. Create another one in Settings › API.
403	`conta de demonstração: a API pública está desligada na vitrine`	The call reached the demo account, where the public API is turned off.
403	`identidade da chave de API irregular`	The account refuses keys with irregular identity (deactivated person or ownerless key). The body brings motivo and comoResolver.
429	`limite de requisições excedido (120/min)`	The key went over its per-minute limit. Wait for Retry-After.
200, with erro in the body	`parâmetro 'desde' inválido — use 2026-08-27 ou 2026-08-27T14:30:00`	desde is neither a date nor a date-time. Comes with status 200.
200, with erro in the body	`parâmetro 'depoisDe' inválido — use o proximoId da resposta anterior`	depoisDe is not a number. Comes with status 200.
200, with erro in the body	`falha ao consultar`	The query failed on our side. Comes with status 200; retry later and, if it persists, check the status page.

Request example

cURL

curl "https://tenka.app.br/api/v1/movimentacoes?limit=50" \
  -H "Authorization: Bearer $TENKA_API_KEY"

JavaScript

const response = await fetch("https://tenka.app.br/api/v1/movimentacoes?limit=50", {
  method: "GET",
  headers: {
    "Authorization": "Bearer " + TENKA_API_KEY
  }
});
const data = await response.json();
if (!response.ok || data.erro) throw new Error(response.status + " " + data.erro);
console.log(data);

Python

import os
import requests

response = requests.get(
    "https://tenka.app.br/api/v1/movimentacoes?limit=50",
    headers={
        "Authorization": f"Bearer {os.environ['TENKA_API_KEY']}",
    },
    timeout=30,
)
data = response.json()
if not response.ok or "erro" in data:
    raise RuntimeError(f"{response.status_code} {data.get('erro')}")
print(data)

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder(URI.create("https://tenka.app.br/api/v1/movimentacoes?limit=50"))
    .header("Authorization", "Bearer " + System.getenv("TENKA_API_KEY"))
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());

using System.Net.Http.Headers;
using System.Text;

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("TENKA_API_KEY"));
var request = new HttpRequestMessage(HttpMethod.Get, "https://tenka.app.br/api/v1/movimentacoes?limit=50");
var response = await http.SendAsync(request);
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");

PHP

<?php
$ch = curl_init("https://tenka.app.br/api/v1/movimentacoes?limit=50");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("TENKA_API_KEY"),
    ],
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$data = json_decode($body, true);
echo $status . " " . $body;

Node (SDK)

// SDK generated from the contract — download at https://tenka.app.br/api/v1/sdk/tenka.js
import { Tenka } from "./tenka.js";

const tenka = new Tenka(process.env.TENKA_API_KEY, "https://tenka.app.br/api/v1");
const data = await tenka.getMovimentacoes({ limit: 50 });
console.log(data);

Response example

200 · application/json

{
  "data": [
    {
      "id": 123,
      "codigo": 1042,
      "descricao": "Mensalidade de outubro",
      "valor": 1500.0,
      "vencimento": "2026-10-10 00:00:00.0",
      "status": "ATIVO"
    }
  ],
  "moeda": "BRL",
  "limit": 50,
  "offset": 0,
  "count": 1
}

Generated from OpenAPI contract v1.2.0, the same one openapi.json publishes. openapi.json