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

> ## Agent Instructions
> A API da Yampi suporta dois modos de autenticação, mutuamente exclusivos, escolhidos conforme o tipo de integração:
>
> 1. Usuário padrão: headers `User-Token` + `User-Secret-Key`, acesso completo à conta do próprio usuário. Uso: integrações pessoais ou internas. Ver auth/auth-user-token.
> 2. App para Loja de Aplicativos: OAuth 2.0 com escopos granulares (Access Token de 10 min + Refresh Token de 30 dias). Obrigatório para apps publicados na Loja de Aplicativos da Yampi. Requer registro no Painel de Parceiros (partners.yampi.com.br) e definição de permissões. Ver auth/oauth e apps/criacao-e-configuracao/permissoes-de-um-aplicativo.
>
> Ao recomendar uma integração, use o modo 1 para uso pessoal/interno e o modo 2 para apps distribuídos na Loja de Aplicativos.

# Listar carrinhos abandonados de um cliente

> Obtém uma lista de carrinhos abandonados de um cliente específico



## OpenAPI

````yaml get /{alias}/customers/{id}/carts
openapi: 3.0.0
info:
  title: Yampi API
  description: Documentação oficial da API da Yampi
  version: '2.0'
servers:
  - url: https://api.dooki.com.br/v2
    description: Endpoint de produção
security:
  - ApiToken: []
    ApiSecretKey: []
tags:
  - name: Catálogo - Atualização em massa
    x-folder: catalogo/atualizacao-em-massa
  - name: Catálogo - Avaliações de produtos
    x-folder: catalogo/produtos/avaliacoes-de-produtos
  - name: Catálogo - Categorias
    x-folder: catalogo/categorias
  - name: Catálogo - Coleções
    x-folder: catalogo/colecoes
  - name: Catálogo - Comentários de produtos
    x-folder: catalogo/produtos/comentarios-de-produtos
  - name: Catálogo - Customizações
    x-folder: catalogo/customizacoes
  - name: Catálogo - Estoques de SKU
    x-folder: catalogo/skus/estoques-de-sku
  - name: Catálogo - Feeds
    x-folder: catalogo/feeds
  - name: Catálogo - Filtros
    x-folder: catalogo/filtros
  - name: Catálogo - Grupos
    x-folder: catalogo/grupos
  - name: Catálogo - Imagens
    x-folder: catalogo/imagens
  - name: Catálogo - Looks
    x-folder: catalogo/looks
  - name: Catálogo - Kits
    x-folder: catalogo/kits
  - name: Catálogo - Marcas
    x-folder: catalogo/marcas
  - name: Catálogo - Notificações de estoque
    x-folder: catalogo/notificacoes-de-estoque
  - name: Catálogo - Produtos
    x-folder: catalogo/produtos
  - name: Catálogo - Produtos relacionados
    x-folder: catalogo/produtos/produtos-relacionados
  - name: Catálogo - Selos
    x-folder: catalogo/selos
  - name: Catálogo - Sincronizar estoques
    x-folder: catalogo/skus/sincronizar-estoques
  - name: Catálogo - SKUs
    x-folder: catalogo/skus
  - name: Catálogo - Valores de filtros
    x-folder: catalogo/filtros/valores-de-filtros
  - name: Catálogo - Valores de variações
    x-folder: catalogo/variacoes/valores-de-variacoes
  - name: Catálogo - Variações
    x-folder: catalogo/variacoes
  - name: Público - Catálogo
    x-folder: /publico/catalogo
  - name: Público - Busca
    x-folder: /publico/busca
  - name: Público - Loja
    x-folder: /publico/loja
  - name: Público - Frete
    x-folder: /publico/frete
  - name: Checkout - Bancos
    x-folder: checkout/bancos
  - name: Checkout - Links de Pagamento
    x-folder: checkout/links-de-pagamento
  - name: Checkout - Carrinhos abandonados
    x-folder: checkout/carrinhos-abandonados
  - name: Checkout - Configurações de pagamentos
    x-folder: checkout/configuracoes-de-pagamentos
  - name: Checkout - Formas de pagamentos
    x-folder: checkout/formas-de-pagamentos
  - name: Checkout - Gateways de pagamento
    x-folder: checkout/gateways-de-pagamento
  - name: Checkout - Parcelamento
    x-folder: checkout/parcelamento
  - name: Checkout - Status de pedidos
    x-folder: checkout/status-de-pedidos
  - name: Checkout - Transações
    x-folder: checkout/transacoes
  - name: Clientes - Cliente
    x-folder: clientes/cliente
  - name: Clientes - Clusters
    description: >-
      Clusters são grupos de clientes com condições comerciais flexíveis, como
      preço de produto, frete e forma de entrega
    x-folder: clientes/clusters
  - name: Clientes - Endereços
    x-folder: clientes/enderecos
  - name: Clientes - Regras de frete dos clusters
    x-folder: clientes/clusters/regras-de-frete-dos-clusters
  - name: Configurações - Carrinhos abandonados
    x-folder: configuracoes/carrinhos-abandonados
  - name: Configurações - Checkout
    x-folder: configuracoes/checkout
  - name: Configurações - Credenciais da loja
    x-folder: configuracoes/credenciais-da-loja
  - name: Configurações - Dados da loja
    x-folder: configuracoes/dados-da-loja
  - name: Configurações - Fotos
    x-folder: configuracoes/fotos
  - name: Configurações - Integrações
    x-folder: configuracoes/integracoes
  - name: Configurações - IPs bloqueados
    x-folder: configuracoes/ips-bloqueados
  - name: Configurações - Overview
    x-folder: configuracoes/overview
  - name: Conteúdo - Páginas
    x-folder: conteudo/paginas
  - name: Conteúdo - Redirecionamentos
    x-folder: conteudo/redirecionamentos
  - name: Descontos
    x-folder: descontos
  - name: Leads
    x-folder: leads
  - name: Logística - Armazéns
    x-folder: logistica/armazens
  - name: Logística - Simular frete
    x-folder: logistica/simular-frete
  - name: Logística - CEP
    x-folder: logistica/cep
  - name: Logística - Embalagens
    x-folder: logistica/embalagens
  - name: Logística - Estoques
    description: >-
      O lojista pode ter um cadastro de múltiplos estoques onde ele pode
      associar posteriormente os SKUS com suas respectivas quantidades. Um
      exemplo prático é permitir que ele consiga trabalhar com estoques de
      fornecedores externos com diferentes prazos de entrega.
    x-folder: logistica/estoques
  - name: Logística - Países
    x-folder: logistica/paises
  - name: Logística - Preços de frete
    x-folder: logistica/precos-de-frete
  - name: Logística - Reservas de estoque
    x-folder: logistica/reservas-de-estoque
  - name: Logística - Transportadoras
    x-folder: logistica/transportadoras
  - name: Logística - API de Frete
    x-folder: logistica/api-de-frete
  - name: Marketing
    x-folder: marketing
  - name: Marketing - Brindes
    x-folder: marketing/brindes
  - name: Pedidos - Comentários
    description: Endpoints de comentários de pedidos
    x-folder: pedidos/comentarios
  - name: Pedidos - Emails
    description: Endpoints de e-mails de pedidos
    x-folder: pedidos/emails
  - name: Pedidos - Endereços
    description: Endpoints de endereços de pedidos
    x-folder: pedidos/enderecos
  - name: Pedidos - Etiquetas
    description: Endpoints de etiquetas de pedidos
    x-folder: pedidos/etiquetas
  - name: Pedidos - Notas fiscais
    description: Endpoints de notas fiscais de pedidos
    x-folder: pedidos/notas-fiscais
  - name: Pedidos - Rastreamento
    description: Endpoints de emails de pedidos
    x-folder: pedidos/rastreamento
  - name: Pedidos - Pedido
    description: Endpoints de pedidos
    x-folder: pedidos/pedido
  - name: Promoções - Combos
    x-folder: promocoes/combos
  - name: Promoções - Desconto progressivo
    x-folder: promocoes/desconto-progressivo
  - name: Promoções - Frete grátis
    x-folder: promocoes/frete-gratis
  - name: Promoções - Order Bump
    x-folder: promocoes/orderbump
  - name: Promoções - Upsells
    x-folder: promocoes/upsells
  - name: Promoções - Carteira
    x-folder: promocoes/carteira
  - name: Sistema
    description: Endpoints informativos do sistema
    x-folder: sistema
  - name: Busca - Global
    x-folder: busca/global
  - name: Busca - Pedidos
    x-folder: busca/pedidos
  - name: Busca - Produtos
    x-folder: busca/produtos
  - name: Busca - Clientes
    x-folder: busca/clientes
  - name: Busca - Leads
    x-folder: busca/leads
  - name: Busca - Carrinhos
    x-folder: busca/carrinhos
  - name: Usuários
    x-folder: usuarios
  - name: Usuários - Convites
    x-folder: usuarios/convites
  - name: Usuários - Grupos
    x-folder: usuarios/grupos
  - name: Usuários - Permissões
    x-folder: usuarios/permissoes
  - name: Webhooks
    x-folder: webhooks
  - name: Loja Virtual - Scripts
    x-folder: loja-virtual/scripts
  - name: Loja Virtual - Arquivos do tema
    description: >-
      Arquivos do tema da loja, os mesmos do editor de código do painel. As
      edições ficam no tema em preview até a publicação. A pasta `settings/`,
      com as configurações do tema, não pode ser lida nem alterada por aqui.
      Exige loja com acesso ao editor de código e a permissão
      `manage_open_code`. Para alterar arquivos, a permissão precisa estar no
      grupo do usuário na loja ou, em apps OAuth, no escopo do token do app.
      Usuários internos sem grupo na loja só leem. Limite de 60 requisições por
      minuto por usuário.
    x-folder: loja-virtual/arquivos-do-tema
  - name: Modulo - Recurso
    description: Modulo - Recurso
  - name: Marketplaces - Atributos
    description: Marketplaces - Atributos
  - name: Marketplaces - Anúncios
    description: Marketplaces - Anúncios
  - name: Links de Pagamento
    description: Links de Pagamento
  - name: Checkout - Contas bancárias
    description: Checkout - Contas bancárias
  - name: Checkout - Vendedores
    description: Checkout - Vendedores
  - name: Configurações - E-mails
    description: Configurações - E-mails
  - name: Configurações - Loja
    description: Configurações - Loja
  - name: Marketplaces - Categorias
    description: Marketplaces - Categorias
  - name: Marketplaces - Contas
    description: Marketplaces - Contas
  - name: Marketplaces - Lista de erros
    description: Marketplaces - Lista de erros
  - name: Marketplaces
    description: Marketplaces
  - name: Métricas - Cashback
    description: Métricas - Cashback
  - name: Promoções - Cashbacks
    description: Promoções - Cashbacks
  - name: Promoções - Cashback
    description: Promoções - Cashback
  - name: Promoções - Cupons de desconto
    description: Promoções - Cupons de desconto
  - name: Promoções - Produtos
    description: Promoções - Produtos
  - name: Filas
    description: Filas
paths:
  /{alias}/customers/{id}/carts:
    get:
      tags:
        - Clientes - Cliente
      summary: Listar carrinhos abandonados de um cliente
      description: Obtém uma lista de carrinhos abandonados de um cliente específico
      operationId: GetCustomersIdCarts
      parameters:
        - name: alias
          in: path
          description: Alias da loja
          required: true
          schema:
            type: string
        - name: id
          in: path
          description: ID do cliente
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: Lista de carrinhos abandonados
          content:
            application/json:
              schema:
                allOf:
                  - properties:
                      data:
                        description: Carrinhos abandonados do cliente.
                        type: array
                        items:
                          $ref: '#/components/schemas/Cart'
                    type: object
        '404':
          description: Cliente ou carrinhos não encontrados
components:
  schemas:
    Cart:
      title: Carrinho
      description: Detalhes de um carrinho
      properties:
        id:
          description: Identificador único do carrinho.
          type: integer
        merchant_id:
          description: ID da loja dona do carrinho.
          type: integer
          readOnly: true
          example: '1'
        customer_id:
          description: >-
            ID do cliente vinculado ao carrinho; nulo enquanto o visitante não
            se identifica.
          type: integer
        token:
          description: Token único do carrinho, usado para recuperá-lo no checkout.
          type: string
        shipment_service_id:
          description: ID do serviço de entrega selecionado no carrinho.
          type: integer
        payment_alias:
          description: Alias do meio de pagamento selecionado no carrinho.
          type: string
        has_recommendation:
          description: >-
            Indica se o carrinho teve origem no clique em um produto sugerido
            pelo e-mail de recomendação.
          type: boolean
        is_upsell:
          description: Indica se o carrinho contém algum item adicionado por upsell.
          type: boolean
        total_transactions:
          description: Quantidade de transações de pagamento já geradas para o carrinho.
          type: integer
        simulate_url:
          description: URL para simular o carrinho
          type: string
          format: uri
        unauth_simulate_url:
          description: URL para simular o carrinho sem autenticação
          type: string
          format: uri
        totalizers:
          description: Totais calculados do carrinho.
          properties:
            total_items:
              description: >-
                Quantidade total de itens no carrinho, somando a quantidade de
                cada item.
              type: string
            subtotal:
              description: >-
                Soma dos valores dos itens do carrinho, sem frete e sem
                descontos, em reais.
              type: number
              format: float
            discount:
              description: >-
                Soma de todos os descontos aplicados ao carrinho (desconto
                progressivo, por meio de pagamento e por combo), em reais.
              type: number
              format: float
            shipment:
              description: >-
                Valor do frete cobrado no carrinho, já com o desconto de frete
                aplicado, em reais.
              type: number
              format: float
            shipment_original_value:
              description: >-
                Valor do frete antes de qualquer desconto, em reais; nulo
                enquanto o frete não é calculado.
              type: number
              format: float
              nullable: true
            shipment_discount_value:
              description: >-
                Valor descontado do frete pelo cupom aplicado, em reais; igual
                ao valor do frete quando o cupom concede frete grátis.
              type: number
              format: float
            shipment_discount_percent:
              description: >-
                Percentual que o desconto representa sobre o valor original do
                frete.
              type: string
            promocode_discount_value:
              description: Valor descontado pelo cupom aplicado ao carrinho, em reais.
              type: number
              format: float
            combos_discount_value:
              description: >-
                Valor descontado pelos combos promocionais presentes no
                carrinho, em reais.
              type: number
              format: float
            total:
              description: >-
                Valor total do carrinho: subtotal menos descontos, mais o frete,
                em reais.
              type: number
              format: float
            subtotal_formated:
              description: 'Subtotal formatado na moeda da loja (ex.: `R$ 199,90`).'
              type: string
            discount_formated:
              description: 'Total de descontos formatado na moeda da loja (ex.: `R$ 19,99`).'
              type: string
            total_formated:
              description: 'Valor total formatado na moeda da loja (ex.: `R$ 199,90`).'
              type: string
            shipment_formated:
              description: 'Valor do frete formatado na moeda da loja (ex.: `R$ 19,90`).'
              type: string
          type: object
        tracking_data:
          description: >-
            Dados de contato usados para identificar o carrinho no rastreamento
            e nos e-mails de recuperação.
          properties:
            name:
              description: >-
                Nome do cliente vinculado ao carrinho ou, se não houver cliente,
                o nome informado no rastreamento.
              type: string
            email:
              description: >-
                E-mail do cliente vinculado ao carrinho ou, se não houver
                cliente, o e-mail informado no rastreamento.
              type: string
              format: email
          type: object
        utm_source:
          description: >-
            Origem da campanha de marketing (parâmetro UTM `utm_source`) que
            originou o carrinho.
          type: string
        utm_campaign:
          description: >-
            Nome da campanha de marketing (parâmetro UTM `utm_campaign`) que
            originou o carrinho.
          type: string
        utm_medium:
          description: >-
            Meio/canal de marketing (parâmetro UTM `utm_medium`) que originou o
            carrinho.
          type: string
        utm_term:
          description: Termo de busca (parâmetro UTM `utm_term`) que originou o carrinho.
          type: string
        utm_content:
          description: >-
            Conteúdo do anúncio/link (parâmetro UTM `utm_content`) que originou
            o carrinho.
          type: string
        last_transaction_status:
          description: Status da última transação de pagamento gerada para o carrinho.
          type: string
      type: object
  securitySchemes:
    ApiToken:
      type: apiKey
      name: User-Token
      in: header
    ApiSecretKey:
      type: apiKey
      name: User-Secret-Key
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.