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

# Gasto do cliente

> Soma o que um comprador já gastou na loja, considerando apenas pedidos aprovados.
<Note>Informe `client_identifier` ou `email`. Se você mandar os dois, os dois entram como filtro e o total sai da interseção, ou seja, dos pedidos que batem com o identificador e com o e-mail ao mesmo tempo.</Note>
Comprador sem nenhum pedido aprovado devolve zero, e não erro. É o endpoint usado para liberar benefício por faixa de gasto, como cargo de VIP acumulado ou desconto por fidelidade.



## OpenAPI

````yaml /openapi/customers.yaml get /app/user_spent
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/user_spent:
    get:
      tags:
        - Clientes
      summary: Gasto do cliente
      description: >-
        Soma o que um comprador já gastou na loja, considerando apenas pedidos
        aprovados.

        <Note>Informe `client_identifier` ou `email`. Se você mandar os dois, os
        dois entram como filtro e o total sai da interseção, ou seja, dos
        pedidos que batem com o identificador e com o e-mail ao mesmo
        tempo.</Note>

        Comprador sem nenhum pedido aprovado devolve zero, e não erro. É o
        endpoint usado para liberar benefício por faixa de gasto, como cargo de
        VIP acumulado ou desconto por fidelidade.
      operationId: getUserSpent
      parameters:
        - name: client_identifier
          in: query
          required: false
          description: >-
            Identificador do comprador na loja, como o nickname em lojas de
            Minecraft
          schema:
            type: string
        - name: email
          in: query
          required: false
          description: E-mail usado nas compras
          schema:
            type: string
        - name: from
          in: query
          required: false
          description: >-
            Considera apenas pedidos criados a partir desta data. Só tem efeito
            junto com `to`. Ex: `2026-01-01`
          schema:
            type: string
        - name: to
          in: query
          required: false
          description: >-
            Considera apenas pedidos criados até esta data. Só tem efeito junto
            com `from`. Ex: `2026-03-31`
          schema:
            type: string
      responses:
        '200':
          description: Total gasto pelo comprador
          content:
            application/json:
              schema:
                type: object
                properties:
                  total_net_received:
                    type: number
                    description: Soma líquida, já descontadas as taxas
                  total_gross_received:
                    type: number
                    description: Soma bruta, do valor pago pelo comprador
              example:
                total_net_received: 240
                total_gross_received: 250
        '400':
          description: Nenhum identificador informado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                errors:
                  - message: >-
                      Informe o client_identifier ou o email para obter um
                      resultado.
components:
  schemas:
    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.

````