> ## Documentation Index
> Fetch the complete documentation index at: https://docs.centralcart.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter cliente

> Ficha de um comprador, agregada na hora a partir dos pedidos dele. Use quando o número precisa estar certo neste instante, como ao liberar um benefício por faixa de gasto logo após a compra.
<Note>No lugar do e-mail você pode passar o identificador do comprador, como o nick em lojas de Minecraft. A API resolve pelo pedido mais recente daquele identificador.</Note>
Aqui `total_spent` é o bruto pago pelo comprador e `total_net_spent` é o líquido da loja, ambos apenas sobre pedidos aprovados. São os mesmos números de [Gasto do cliente](/api-reference/clientes/gasto-do-cliente), acompanhados do resto da ficha.



## OpenAPI

````yaml /openapi/customers.yaml get /app/customer/{email}
openapi: 3.1.0
info:
  title: CentralCart API
  version: 1.0.0
  description: >-
    Consultas sobre os compradores da loja. Os endpoints aqui usam o escopo
    `customers:read` da chave de API.
servers:
  - url: https://api.centralcart.io/v1
    description: Produção
security:
  - bearerAuth: []
paths:
  /app/customer/{email}:
    get:
      tags:
        - Clientes
      summary: Obter cliente
      description: >-
        Ficha de um comprador, agregada na hora a partir dos pedidos dele. Use
        quando o número precisa estar certo neste instante, como ao liberar um
        benefício por faixa de gasto logo após a compra.

        <Note>No lugar do e-mail você pode passar o identificador do comprador,
        como o nick em lojas de Minecraft. A API resolve pelo pedido mais
        recente daquele identificador.</Note>

        Aqui `total_spent` é o bruto pago pelo comprador e `total_net_spent` é o
        líquido da loja, ambos apenas sobre pedidos aprovados. São os mesmos
        números de [Gasto do cliente](/api-reference/clientes/gasto-do-cliente),
        acompanhados do resto da ficha.
      operationId: getCustomer
      parameters:
        - name: email
          in: path
          required: true
          description: E-mail do comprador, ou o identificador dele
          schema:
            type: string
      responses:
        '200':
          description: Ficha do comprador
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomerDetail'
              example:
                name: Oliver Souza
                email: oliver@exemplo.com
                client_identifier: OliverMC
                orders_count: 5
                approved_orders_count: 4
                total_spent: 180
                total_net_spent: 178.4
                first_order_at: '2026-02-11T14:02:00.000-03:00'
                last_order_at: '2026-08-19T09:31:00.000-03:00'
                is_banned: false
        '404':
          description: Nenhum pedido deste comprador na loja
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                errors:
                  - message: Cliente não encontrado.
components:
  schemas:
    CustomerDetail:
      type: object
      properties:
        name:
          type: string
        email:
          type: string
        client_identifier:
          type: string
          nullable: true
          description: Identificador do pedido mais recente
        orders_count:
          type: number
          description: Todos os pedidos, incluindo os pendentes
        approved_orders_count:
          type: number
          description: Apenas os aprovados
        total_spent:
          type: number
          description: Soma bruta paga pelo comprador, só de pedidos aprovados
        total_net_spent:
          type: number
          description: Soma líquida recebida pela loja, só de pedidos aprovados
        first_order_at:
          type: string
          nullable: true
          description: Data da primeira compra aprovada
        last_order_at:
          type: string
          nullable: true
          description: Data da última compra aprovada
        is_banned:
          type: boolean
    Error:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
              code:
                type: string
              ref:
                type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Token de API gerado no painel da CentralCart.

````