Change log

Change log of a /clientes record

GET/api/v1/clientes/{id}/alteracoes

The record's change trail: each changed field, old value, new value, who and when — the same the screen shows. The account turns this resource on and off in Parameters.

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.
`id`	path	integer	yes	Record id (the id field of the list).

Response fields

Name	Type	Description
`recurso`	string	The queried resource.
`id`	integer	Record identifier. Use it in by-id calls.
`total`	integer	Total items.
`alteracoes`	array	The record's changes.
`alteracoes[].quando`	string (date and time)	Date and time of the change.
`alteracoes[].campo`	string	Technical name of the changed field.
`alteracoes[].rotulo`	string	Field label as the screen shows it.
`alteracoes[].de`	string	Old value.
`alteracoes[].para`	string	New value.
`alteracoes[].quem`	string	Who changed it.

Status codes

HTTP	Description
200	{recurso, id, total, alteracoes[{quando, campo, rotulo, de, para, quem}]}
403	change log turned off for this account

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.
403	`o log de alterações via API está desligado nesta conta (parâmetro API.LOG_ALTERACOES_ATIVO)`	The account turned off the API change log. The trail is still recorded and visible on screen.
400	`id inválido`	The id in the URL is not a number.
404	`recurso sem trilha de alterações`	The resource has no change trail. The response lists those that do.

Request example

cURL

curl "https://tenka.app.br/api/v1/clientes/123/alteracoes" \
  -H "Authorization: Bearer $TENKA_API_KEY"

JavaScript

const response = await fetch("https://tenka.app.br/api/v1/clientes/123/alteracoes", {
  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/clientes/123/alteracoes",
    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/clientes/123/alteracoes"))
    .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/clientes/123/alteracoes");
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/clientes/123/alteracoes");
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.getClientesIdAlteracoes(123, {});
console.log(data);

Response example

200 · application/json

{
  "recurso": "/clientes",
  "id": 123,
  "total": 1,
  "alteracoes": [
    {
      "quando": "2026-10-04T09:30:12",
      "campo": "email",
      "rotulo": "E-mail",
      "de": "antigo@exemplo.com",
      "para": "novo@exemplo.com",
      "quem": "Ana Souza"
    }
  ]
}

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