Skip to main content
GET
/
public_api
/
customers
/
{id}
/
cURL
curl --request GET \
  --url https://api.cakto.com.br/public_api/customers/{id}/ \
  --header 'Authorization: Bearer <token>'
{
  "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"
  }
}

​
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

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.
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.
Analise clientes com transações antigas e pouca recorrência para disparar campanhas de reengajamento com ofertas personalizadas baseadas no histórico de compras.
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

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.
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.
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

​
Authorization
string
header
required

Token de autenticação do tipo Bearer {access_token}, onde {access_token} é o token obtido no fluxo de autenticação.

Path Parameters

​
id
integer
required

Id do Cliente

Response

Corpo da resposta status 200

​
averageOrder
number
required

Valor médio dos pedidos pagos

​
totalSpent
number
required

Valor total gasto em pedidos pagos

​
paidOrderCount
integer
required

Quantidade de pedidos pagos

​
totalOrdersCount
integer
required

Total de pedidos

​
transactions
object[]
required

Lista com até 3 pedidos mais recentes

​
customer
object
required