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

# Retrieve performance

> Recupere as métricas de desempenho de uma sequência específica na conta da HubSpot. Este endpoint fornece insights detalhados sobre a eficácia da sequência, incluindo métricas como taxas de abertura, cliques e respostas. É útil para analisar o sucesso das suas sequências ao longo do tempo. Observação: os escopos para este endpoint exigem acesso em nível de usuário e não funcionarão para aplicativos existentes com acesso em nível de portal.

> **Supported products**

> **Required Scopes**


## OpenAPI

````yaml specs/2026-09/automation-sequences-v2026-09.json GET /automation/sequences/2026-09/serviceaccounts/sequences/{sequenceId}/performance
openapi: 3.0.1
info:
  title: Automation Sequences
  description: Basepom for all HubSpot Projects
  version: 2026-09
  x-hubspot-product-tier-requirements:
    marketing: FREE
    sales: FREE
    service: FREE
    cms: FREE
    commerce: FREE
    crmHub: FREE
    dataHub: FREE
servers:
  - url: https://api.hubapi.com
security: []
tags:
  - name: Basic
  - name: Enrollment
paths:
  /automation/sequences/2026-09/serviceaccounts/sequences/{sequenceId}/performance:
    get:
      tags:
        - Basic
      summary: Recuperar desempenho
      description: >-
        Recupere as métricas de desempenho de uma sequência específica na conta
        da HubSpot. Este endpoint fornece insights detalhados sobre a eficácia
        da sequência, incluindo métricas como taxas de abertura, cliques e
        respostas. É útil para analisar o sucesso das suas sequências ao longo
        do tempo. Observação: os escopos para este endpoint exigem acesso em
        nível de usuário e não funcionarão para aplicativos existentes com
        acesso em nível de portal.
      operationId: >-
        get-/automation/sequences/2026-09/serviceaccounts/sequences/{sequenceId}/performance
      parameters:
        - name: sequenceId
          in: path
          description: >-
            O identificador exclusivo da sequência para a qual as métricas de
            desempenho serão recuperadas.
          required: true
          style: simple
          explode: false
          schema:
            type: string
        - name: timelineInterval
          in: query
          description: O intervalo para os dados da linha do tempo. O padrão é "WEEK".
          required: false
          style: form
          explode: true
          schema:
            type: string
            default: WEEK
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicSequencePerformanceResponse'
        default:
          $ref: '#/components/responses/Error'
          description: ''
      security: []
components:
  schemas:
    PublicSequencePerformanceResponse:
      required:
        - sequenceId
        - statusByStep
        - steps
        - summary
        - timeline
      type: object
      properties:
        companyMetrics:
          $ref: '#/components/schemas/PublicSequenceCompanyMetricsResponse'
        sequenceId:
          type: string
          description: >-
            O identificador exclusivo da sequência, representado como uma
            string.
        statusByStep:
          type: array
          description: >-
            Uma matriz de objetos que detalham o status de inscrição para cada
            etapa na sequência, incluindo a contagem e a ordem atual das etapas.
          items:
            $ref: '#/components/schemas/PublicSequenceEnrollmentStatusByStepResponse'
        steps:
          type: array
          description: >-
            Uma matriz de objetos, cada um representando as métricas de
            desempenho para etapas individuais dentro da sequência.
          items:
            $ref: '#/components/schemas/PublicSequenceStepPerformanceResponse'
        summary:
          $ref: '#/components/schemas/PublicSequencePerformanceSummaryResponse'
        timeline:
          type: array
          description: >-
            Uma matriz de objetos que representam pontos no tempo com métricas
            de desempenho específicas, como inscrições e reuniões agendadas.
          items:
            $ref: '#/components/schemas/PublicSequenceTimelinePointResponse'
    PublicSequenceCompanyMetricsResponse:
      required:
        - companiesEngaged
        - companiesEnrolled
        - companiesScheduledMeeting
        - contactsEnrolledWithCompanyId
      type: object
      properties:
        companiesEngaged:
          type: integer
          description: >-
            O número de empresas que interagiram com a sequência. Um número
            inteiro no formato int64.
          format: int64
        companiesEnrolled:
          type: integer
          description: >-
            O número de empresas que foram inscritas na sequência. Um número
            inteiro no formato int64.
          format: int64
        companiesScheduledMeeting:
          type: integer
          description: >-
            O número de empresas que agendaram uma reunião como resultado da
            sequência. Um número inteiro no formato int64.
          format: int64
        contactsEnrolledWithCompanyId:
          type: integer
          description: >-
            O número de contatos inscritos na sequência que estão associados a
            um ID de empresa. Um número inteiro no formato int64.
          format: int64
    PublicSequenceEnrollmentStatusByStepResponse:
      required:
        - count
        - currentStepOrder
        - enrollmentStatus
      type: object
      properties:
        count:
          type: integer
          description: >-
            Um número inteiro no formato int64 que representa o número de
            inscrições na etapa atual.
          format: int64
        currentStepOrder:
          type: integer
          description: Um número inteiro que indica a ordem da etapa atual na sequência.
          format: int32
        enrollmentStatus:
          type: string
          description: Uma string que representa o status da inscrição na etapa atual.
    PublicSequenceStepPerformanceResponse:
      required:
        - calls
        - callsConnected
        - clicked
        - executionCount
        - meetingsBooked
        - onTimeTaskCompletionCount
        - onTimeTaskCompletionSum
        - opened
        - personalizationRateCount
        - replied
        - stepKey
        - stepOrder
        - tasksCompleted
      type: object
      properties:
        calls:
          type: integer
          description: >-
            Um número inteiro (int64) que representa o número de chamadas feitas
            nesta etapa.
          format: int64
        callsConnected:
          type: integer
          description: >-
            Um número inteiro (int64) que indica o número de chamadas conectadas
            com sucesso nesta etapa.
          format: int64
        clicked:
          type: integer
          description: >-
            Um número inteiro (int64) que mostra o número de vezes que os links
            em e-mails desta etapa foram clicados.
          format: int64
        executionCount:
          type: integer
          description: >-
            Um número inteiro (int64) que indica o número de vezes que esta
            etapa foi executada.
          format: int64
        meetingsBooked:
          type: integer
          description: >-
            Um número inteiro (int64) que representa o número de reuniões
            agendadas como resultado desta etapa.
          format: int64
        onTimeTaskCompletionCount:
          type: integer
          description: >-
            Um número inteiro (int64) que representa o número de tarefas
            concluídas no prazo nesta etapa.
          format: int64
        onTimeTaskCompletionSum:
          type: integer
          description: >-
            Um número inteiro (int64) que indica a soma das conclusões de
            tarefas no prazo para esta etapa.
          format: int64
        opened:
          type: integer
          description: >-
            Um número inteiro (int64) que indica quantas vezes os e-mails desta
            etapa foram abertos.
          format: int64
        personalizationRateAvg:
          type: number
          description: >-
            Um número que representa a taxa média de personalização para esta
            etapa.
        personalizationRateCount:
          type: integer
          description: >-
            Um número inteiro (int64) que indica a contagem de ações
            personalizadas nesta etapa.
          format: int64
        replied:
          type: integer
          description: >-
            Um número inteiro (int64) que representa o número de respostas
            recebidas de e-mails enviados nesta etapa.
          format: int64
        stepKey:
          type: string
          description: Uma string que identifica exclusivamente a etapa.
        stepOrder:
          type: integer
          description: Um número inteiro que representa a ordem da etapa na sequência.
          format: int32
        tasksCompleted:
          type: integer
          description: >-
            Um número inteiro (int64) que indica o número de tarefas concluídas
            nesta etapa.
          format: int64
    PublicSequencePerformanceSummaryResponse:
      required:
        - bounced
        - clicked
        - contacts
        - engaged
        - enrolled
        - meetingsBooked
        - noResponse
        - opened
        - replied
        - unsubscribed
      type: object
      properties:
        associatedDeals:
          type: integer
          description: >-
            O número de negócios associados à sequência. Representado como um
            número inteiro no formato int64.
          format: int64
        bounced:
          type: integer
          description: >-
            O número de e-mails na sequência que foram rejeitados. Representado
            como um número inteiro no formato int64.
          format: int64
        clicked:
          type: integer
          description: >-
            O número de vezes que os links nos e-mails da sequência foram
            clicados. Representado como um número inteiro no formato int64.
          format: int64
        contacts:
          type: integer
          description: >-
            O número total de contatos associados à sequência. Representado como
            um número inteiro no formato int64.
          format: int64
        dealsClosed:
          type: integer
          description: >-
            O número de negócios fechados como resultado da sequência.
            Representado como um número inteiro no formato int64.
          format: int64
        engaged:
          type: integer
          description: >-
            O número de contatos que interagiram com a sequência. Representado
            como um número inteiro no formato int64.
          format: int64
        enrolled:
          type: integer
          description: >-
            O número de contatos inscritos na sequência. Representado como um
            número inteiro no formato int64.
          format: int64
        meetingsBooked:
          type: integer
          description: >-
            O número de reuniões agendadas como resultado da sequência.
            Representado como um número inteiro no formato int64.
          format: int64
        noResponse:
          type: integer
          description: >-
            O número de contatos que não responderam à sequência. Representado
            como um número inteiro no formato int64.
          format: int64
        opened:
          type: integer
          description: >-
            O número de vezes que os e-mails na sequência foram abertos.
            Representado como um número inteiro no formato int64.
          format: int64
        replied:
          type: integer
          description: >-
            O número de respostas recebidas dos e-mails na sequência.
            Representado como um número inteiro no formato int64.
          format: int64
        totalRevenue:
          type: number
          description: >-
            A receita total gerada a partir da sequência. Representada como um
            número.
        unsubscribed:
          type: integer
          description: >-
            O número de contatos que cancelaram a inscrição na sequência.
            Representado como um número inteiro no formato int64.
          format: int64
    PublicSequenceTimelinePointResponse:
      required:
        - enrolledAt
        - enrollments
        - meetingsBooked
      type: object
      properties:
        enrolledAt:
          type: integer
          description: >-
            O horário em que a inscrição ocorreu, representado como uma
            data/hora Unix em milissegundos.
          format: int64
        enrollments:
          type: integer
          description: >-
            O número total de inscrições registradas neste ponto da linha do
            tempo da sequência. Representado como um número inteiro.
          format: int64
        meetingsBooked:
          type: integer
          description: >-
            O número de agendamentos de reuniões neste ponto da linha do tempo
            da sequência. Representado como um número inteiro.
          format: int64
    Error:
      required:
        - category
        - correlationId
        - message
      type: object
      properties:
        category:
          type: string
          description: A categoria de erro, indicando o tipo geral de erro que ocorreu.
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: >-
            Contexto sobre a condição de erro, representado como um objeto com
            propriedades adicionais que são arrays de strings.
          example: >-
            {invalidPropertyName=[propertyValue], missingScopes=[scope1,
            scope2]}
        correlationId:
          type: string
          description: >-
            O identificador exclusivo da solicitação. Inclua este valor em
            relatórios de erro ou tickets de suporte. Ele é formatado como um
            UUID.
          format: uuid
          example: aeb5f871-7f07-4993-9211-075dc63e7cbf
        errors:
          type: array
          description: >-
            Mais informações sobre o erro, representadas como uma matriz de
            objetos ErrorDetail.
          items:
            $ref: '#/components/schemas/ErrorDetail'
        links:
          type: object
          additionalProperties:
            type: string
          description: >-
            Um mapa de nomes de links para URIs associados que contêm
            documentação sobre o erro ou etapas de correção recomendadas.
        message:
          type: string
          description: >-
            Uma mensagem legível por humanos que descreve o erro, juntamente com
            as etapas de correção, quando apropriado.
          example: An error occurred
        subCategory:
          type: string
          description: >-
            Uma categoria específica que contém detalhes mais específicos sobre
            o erro. Esta é uma propriedade de string.
      description: >-
        Representa uma resposta de erro retornada pela API quando uma operação
        falha. Este componente é usado em vários endpoints para fornecer
        informações detalhadas sobre o erro encontrado.
      example:
        message: Invalid input (details will vary based on the error)
        correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
        category: VALIDATION_ERROR
        links:
          knowledge-base: https://www.hubspot.com/products/service/knowledge-base
    ErrorDetail:
      required:
        - message
      type: object
      properties:
        code:
          type: string
          description: >-
            O código de status associado ao detalhe do erro, indicando o tipo de
            erro encontrado.
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: >-
            Contexto sobre a condição de erro, fornecido como um objeto com
            propriedades adicionais. Isso pode incluir detalhes específicos,
            como escopos ausentes.
          example: '{missingScopes=[scope1, scope2]}'
        in:
          type: string
          description: >-
            O nome do campo ou parâmetro em que o erro foi encontrado. Isso
            fornece contexto sobre onde o erro ocorreu.
        message:
          type: string
          description: >-
            Uma mensagem legível por humanos que descreve o erro, juntamente com
            as etapas de correção, quando apropriado. Esta é uma propriedade de
            string obrigatória.
        subCategory:
          type: string
          description: >-
            Uma categoria específica que contém detalhes mais específicos sobre
            o erro, ajudando a classificá-lo ainda mais.
      description: >-
        Representa informações detalhadas sobre um erro ocorrido na API. Este
        componente é usado para fornecer contexto e detalhes adicionais sobre os
        erros, geralmente como parte de uma resposta de erro.
  responses:
    Error:
      description: An error occurred.
      content:
        '*/*':
          schema:
            $ref: '#/components/schemas/Error'

````