cURL
curl --request GET \
--url https://api.cakto.com.br/public_api/customers/{id}/ \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.cakto.com.br/public_api/customers/{id}/"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.cakto.com.br/public_api/customers/{id}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cakto.com.br/public_api/customers/{id}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://api.cakto.com.br/public_api/customers/{id}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_bodyHttpResponse<String> response = Unirest.get("https://api.cakto.com.br/public_api/customers/{id}/")
.header("Authorization", "Bearer <token>")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.cakto.com.br/public_api/customers/{id}/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
{
"averageOrder": 97,
"totalSpent": 291,
"paidOrderCount": 3,
"totalOrdersCount": 3,
"transactions": [
{
"id": "order_101",
"amount": "97.00",
"status": "paid",
"createdAt": "2025-10-03T11:19:35.019507-03:00"
},
{
"id": "order_102",
"amount": "97.00",
"status": "paid",
"createdAt": "2025-10-02T14:22:10.123456-03:00"
},
{
"id": "order_103",
"amount": "97.00",
"status": "paid",
"createdAt": "2025-09-28T09:05:00.987654-03:00"
}
],
"customer": {
"id": 1,
"name": "João da Silva",
"email": "joao@example.com",
"birthDate": "1990-05-15",
"phone": "*********7777",
"docType": "cpf",
"docNumber": "111******77"
}
}{
"detail": "As credenciais de autenticação não foram fornecidas."
}{
"detail": "Não encontrado."
}Clientes
Obter Cliente
Acesse o perfil completo de um cliente, incluindo histórico de compras, métricas de gastos e transações recentes para personalizar atendimento e estratégias de fidelização.
GET
/
public_api
/
customers
/
{id}
/
cURL
curl --request GET \
--url https://api.cakto.com.br/public_api/customers/{id}/ \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.cakto.com.br/public_api/customers/{id}/"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.cakto.com.br/public_api/customers/{id}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cakto.com.br/public_api/customers/{id}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://api.cakto.com.br/public_api/customers/{id}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_bodyHttpResponse<String> response = Unirest.get("https://api.cakto.com.br/public_api/customers/{id}/")
.header("Authorization", "Bearer <token>")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.cakto.com.br/public_api/customers/{id}/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
{
"averageOrder": 97,
"totalSpent": 291,
"paidOrderCount": 3,
"totalOrdersCount": 3,
"transactions": [
{
"id": "order_101",
"amount": "97.00",
"status": "paid",
"createdAt": "2025-10-03T11:19:35.019507-03:00"
},
{
"id": "order_102",
"amount": "97.00",
"status": "paid",
"createdAt": "2025-10-02T14:22:10.123456-03:00"
},
{
"id": "order_103",
"amount": "97.00",
"status": "paid",
"createdAt": "2025-09-28T09:05:00.987654-03:00"
}
],
"customer": {
"id": 1,
"name": "João da Silva",
"email": "joao@example.com",
"birthDate": "1990-05-15",
"phone": "*********7777",
"docType": "cpf",
"docNumber": "111******77"
}
}{
"detail": "As credenciais de autenticação não foram fornecidas."
}{
"detail": "Não encontrado."
}Escopo
read orders
O que é este endpoint?
Este endpoint retorna uma visão detalhada de um cliente específico que realizou compras pagas nos seus produtos. Além dos dados cadastrais, a resposta inclui métricas de compra e as transações mais recentes, permitindo que você entenda o comportamento e o valor desse cliente para o seu negócio. Por motivos de privacidade e segurança, informações sensíveis como telefone e documento são retornadas de forma mascarada.Por que obter os dados detalhados de um cliente?
Conhecer o histórico e o valor de um comprador permite tomar decisões mais assertivas em atendimento, marketing e retenção.Atendimento personalizado
Tenha em mãos o histórico de compras e o valor total gasto para oferecer um suporte mais rápido, humanizado e contextualizado.
Identificar clientes VIP
Use as métricas de gastos e quantidade de pedidos para reconhecer compradores de alto valor e criar experiências exclusivas.
Recuperação de carrinho
Analise as transações recentes para identificar padrões de compra e criar ofertas direcionadas no momento certo.
Base para decisões
Entenda o perfil de gastos do cliente para definir políticas de desconto, condições especiais ou limites de crédito.
Casos de uso
Suporte e atendimento
Suporte e atendimento
Quando um cliente entra em contato, acesse seu perfil completo em segundos. Veja o histórico de compras, valores gastos e pedidos recentes para resolver dúvidas, confirmar pagamentos ou escalar solicitações com contexto completo.
Programas de fidelidade
Programas de fidelidade
Identifique clientes com alto total de pedidos pagos ou ticket médio elevado para convidá-los para programas VIP, oferecer benefícios exclusivos ou antecipar lançamentos.
Recuperação de clientes
Recuperação de clientes
Analise clientes com transações antigas e pouca recorrência para disparar campanhas de reengajamento com ofertas personalizadas baseadas no histórico de compras.
Análise de perfil de compra
Análise de perfil de compra
Entenda o comportamento de compra individual: ticket médio, frequência, método de pagamento preferido e produtos adquiridos. Use esses dados para recomendações personalizadas.
Insights que podem ser obtidos
Valor do cliente ao longo do tempo
Valor do cliente ao longo do tempo
A métrica
totalSpent mostra o quanto o cliente já investiu nos seus produtos. Compreender esse valor ajuda a priorizar atendimento, definir investimentos em retenção e calcular o retorno de ações específicas.Frequência de compra
Frequência de compra
Ao analisar
paidOrderCount e as transações recentes, você consegue identificar se o cliente compra com regularidade, se está inativo ou se teve um pico de interesse recente.Ticket médio e padrões
Ticket médio e padrões
O campo
averageOrder revela o valor típico de compra do cliente. Isso é essencial para criar ofertas compatíveis com o perfil de gastos e aumentar o valor do carrinho.Response
Clientes com alto valor de vida útil (LTV) merecem atenção especial. Ao combinar os dados deste endpoint com informações de assinaturas e campanhas, você consegue criar experiências personalizadas que aumentam a retenção e o faturamento por cliente.
Authorizations
Token de autenticação do tipo Bearer {access_token}, onde {access_token} é o token obtido no fluxo de autenticação.
Path Parameters
Response
Corpo da resposta status 200
Valor médio dos pedidos pagos
Valor total gasto em pedidos pagos
Quantidade de pedidos pagos
Total de pedidos
Lista com até 3 pedidos mais recentes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Was this page helpful?