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

# Retrieve sequence

> Retrieve details of a specific sequence in your HubSpot account using the sequence ID. This endpoint provides comprehensive information about the sequence, including its settings, steps, and dependencies. It is useful for obtaining sequence configurations and understanding the sequence's structure and components. Please note: the scopes for this endpoint requires user-level access and will not work for existing apps with portal-level access.

export const ScopesList = ({scopes = [], description = "This API requires one of the following scopes:"}) => {
  if (!scopes || scopes.length === 0) {
    return null;
  }
  const sortedScopes = scopes.sort((a, b) => a.localeCompare(b));
  return <div>
      <div className="text-sm mb-2">{description}</div>
      <div>
        {sortedScopes.map((scope, index) => <div key={index}>
            <code>
              <span className="text-xs">{scope}</span>
            </code>
          </div>)}
      </div>
    </div>;
};

export const SupportedProducts = ({marketing, sales, service, cms, data, commerce, crm, marketingLevel, salesLevel, serviceLevel, cmsLevel, dataLevel, commerceLevel, crmLevel}) => {
  const translations = {
    description: "Requires one of the following products or higher.",
    productNames: {
      marketing: "Marketing Hub",
      sales: "Sales Hub",
      service: "Service Hub",
      cms: "Content Hub",
      data: "Data Hub",
      commerce: "Revenue Hub",
      crm: "Smart CRM"
    },
    tiers: {
      free: "Free",
      starter: "Starter",
      professional: "Professional",
      enterprise: "Enterprise"
    }
  };
  const translateTier = tier => {
    if (!tier) return '';
    const lowerTier = tier.toLowerCase();
    return translations.tiers[lowerTier] || tier;
  };
  const products = [{
    name: marketing ? translations.productNames.marketing : '',
    level: translateTier(marketingLevel),
    icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/MarketingHub.svg",
    alt: "Marketing Hub"
  }, {
    name: sales ? translations.productNames.sales : '',
    level: translateTier(salesLevel),
    icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/SalesHub.svg",
    alt: "Sales Hub"
  }, {
    name: service ? translations.productNames.service : '',
    level: translateTier(serviceLevel),
    icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/ServiceHub.svg",
    alt: "Service Hub"
  }, {
    name: cms ? translations.productNames.cms : '',
    level: translateTier(cmsLevel),
    icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/ContentHub.svg",
    alt: "Content Hub"
  }, {
    name: data ? translations.productNames.data : '',
    level: translateTier(dataLevel),
    icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/DataHub.svg",
    alt: "Data Hub"
  }, {
    name: commerce ? translations.productNames.commerce : '',
    level: translateTier(commerceLevel),
    icon: "https://www.hubspot.com/hubfs/Knowledge_Base/subscription_key_icons/commerce_icon.svg",
    alt: "Revenue Hub"
  }, {
    name: crm ? translations.productNames.crm : '',
    level: translateTier(crmLevel),
    icon: "https://www.hubspot.com/hubfs/Knowledge_Base_2023-24-25/developer/icons/SmartCRM.svg",
    alt: "Smart CRM"
  }].filter(product => product.name && product.level);
  if (products.length === 0) return null;
  return <div>
      <div className="text-sm mb-2">{translations.description}</div>
      <div className={`grid ${products.length === 1 ? 'grid-cols-1' : 'grid-cols-2'} gap-1.5`}>
        {products.map((product, index) => <div key={index} style={{
    display: 'flex',
    alignItems: 'center'
  }}>
            <img src={product.icon} alt={product.alt} className="w-3.5 h-3.5 mr-1.5 mt-2.5 mb-2.5 flex-shrink-0 align-middle" />
            <span className="font-medium mr-1 text-sm">{product.name} -</span>
            <span className="text-sm">{product.level}</span>
          </div>)}
      </div>
    </div>;
};

<AccordionGroup>
  <Accordion title="Supported products" defaultOpen="true" icon="cubes">
    <SupportedProducts sales={true} service={true} salesLevel="PROFESSIONAL" serviceLevel="PROFESSIONAL" />
  </Accordion>

  <Accordion title="Required Scopes" icon="key">
    <ScopesList
      scopes={[
  'automation.sequences.read'
]}
    />
  </Accordion>
</AccordionGroup>


## OpenAPI

````yaml specs/2026-09-beta/automation-sequences-v2026-09-beta.json GET /automation/sequences/2026-09-beta/serviceaccounts/sequences/{sequenceId}
openapi: 3.0.1
info:
  title: Automation Sequences
  description: Basepom for all HubSpot Projects
  version: 2026-09-beta
  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-beta/serviceaccounts/sequences/{sequenceId}:
    get:
      tags:
        - Basic
      summary: Retrieve sequence
      description: >-
        Retrieve details of a specific sequence in your HubSpot account using
        the sequence ID. This endpoint provides comprehensive information about
        the sequence, including its settings, steps, and dependencies. It is
        useful for obtaining sequence configurations and understanding the
        sequence's structure and components. Please note: the scopes for this
        endpoint requires user-level access and will not work for existing apps
        with portal-level access.
      operationId: >-
        get-/automation/sequences/2026-09-beta/serviceaccounts/sequences/{sequenceId}
      parameters:
        - name: sequenceId
          in: path
          description: The unique identifier of the sequence to retrieve.
          required: true
          style: simple
          explode: false
          schema:
            type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicSequenceResponseV2'
        default:
          $ref: '#/components/responses/Error'
          description: ''
      security:
        - oauth2:
            - automation.sequences.read
components:
  schemas:
    PublicSequenceResponseV2:
      required:
        - createdAt
        - dependencies
        - id
        - name
        - steps
        - updatedAt
        - userId
      type: object
      properties:
        createdAt:
          type: string
          description: The date and time when the sequence was created, in ISO 8601 format.
          format: date-time
        dependencies:
          type: array
          description: >-
            An array of dependencies between steps in the sequence, each
            represented by a PublicSequenceStepDependencyResponse object.
          items:
            $ref: '#/components/schemas/PublicSequenceStepDependencyResponse'
        folderId:
          type: string
          description: The identifier for the folder containing the sequence.
        id:
          type: string
          description: The unique identifier for the sequence.
        name:
          type: string
          description: The name of the sequence.
        settings:
          $ref: '#/components/schemas/PublicSequenceSettingsResponse'
        steps:
          type: array
          description: >-
            An array of steps included in the sequence, each represented by a
            PublicSequenceStepResponseV2 object.
          items:
            $ref: '#/components/schemas/PublicSequenceStepResponseV2'
        updatedAt:
          type: string
          description: >-
            The date and time when the sequence was last updated, in ISO 8601
            format.
          format: date-time
        userId:
          type: string
          description: The unique identifier of the user who owns the sequence.
    PublicSequenceStepDependencyResponse:
      required:
        - createdAt
        - dependencyType
        - id
        - reliesOnSequenceStepId
        - reliesOnStepOrder
        - requiredBySequenceStepId
        - requiredByStepOrder
        - updatedAt
      type: object
      properties:
        createdAt:
          type: string
          description: >-
            The date and time when this dependency was created, in ISO 8601
            format.
          format: date-time
        dependencyType:
          type: string
          description: >-
            The type of dependency, which can be either 'TASK_COMPLETION' or
            'MANUAL_PAUSE'.
          enum:
            - ADAPTIVE_COMPLETION
            - MANUAL_PAUSE
            - TASK_COMPLETION
        id:
          type: string
          description: The unique identifier for this dependency.
        reliesOnSequenceStepId:
          type: string
          description: >-
            The unique identifier of the sequence step that this dependency
            relies on.
        reliesOnStepOrder:
          type: integer
          description: The order number of the step that this dependency relies on.
          format: int32
        requiredBySequenceStepId:
          type: string
          description: >-
            The unique identifier of the sequence step that requires this
            dependency.
        requiredByStepOrder:
          type: integer
          description: The order number of the step that requires this dependency.
          format: int32
        updatedAt:
          type: string
          description: >-
            The date and time when this dependency was last updated, in ISO 8601
            format.
          format: date-time
    PublicSequenceSettingsResponse:
      required:
        - createdAt
        - eligibleFollowUpDays
        - id
        - individualTaskRemindersEnabled
        - sellingStrategy
        - sendWindowEndMinute
        - sendWindowStartMinute
        - taskReminderMinute
        - updatedAt
      type: object
      properties:
        createdAt:
          type: string
          description: >-
            The date and time when the sequence settings were created, in ISO
            8601 format.
          format: date-time
        eligibleFollowUpDays:
          type: string
          description: >-
            Specifies the days eligible for follow-ups. Valid values include
            'EVERYDAY', 'BUSINESS_DAYS', and 'WEEKDAYS_ONLY'.
          enum:
            - BUSINESS_DAYS
            - EVERYDAY
            - WEEKDAYS_ONLY
        id:
          type: string
          description: The unique identifier for the sequence settings.
        individualTaskRemindersEnabled:
          type: boolean
          description: A boolean indicating whether individual task reminders are enabled.
        sellingStrategy:
          type: string
          description: >-
            The strategy used for selling, which can be either 'LEAD_BASED' or
            'ACCOUNT_BASED'.
          enum:
            - ACCOUNT_BASED
            - LEAD_BASED
        sendWindowEndMinute:
          type: integer
          description: >-
            The ending minute of the window during which emails can be sent,
            represented as an integer.
          format: int32
        sendWindowStartMinute:
          type: integer
          description: >-
            The starting minute of the window during which emails can be sent,
            represented as an integer.
          format: int32
        taskReminderMinute:
          type: integer
          description: >-
            The minute at which task reminders are sent, represented as an
            integer.
          format: int32
        updatedAt:
          type: string
          description: >-
            The date and time when the sequence settings were last updated, in
            ISO 8601 format.
          format: date-time
    PublicSequenceStepResponseV2:
      required:
        - actionType
        - createdAt
        - delayMillis
        - id
        - stepOrder
        - updatedAt
      type: object
      properties:
        actionType:
          type: string
          description: >-
            The type of action to be performed in this step. Valid values
            include 'EMAIL', 'TASK', and 'FINISH_ENROLLMENT'.
          enum:
            - ADAPTIVE_CONTAINER
            - EMAIL
            - FINISH_ENROLLMENT
            - TASK
        createdAt:
          type: string
          description: The date and time when this step was created, in ISO 8601 format.
          format: date-time
        delayMillis:
          type: integer
          description: The delay before this step is executed, specified in milliseconds.
          format: int64
        emailPattern:
          $ref: '#/components/schemas/PublicEmailPatternResponse'
        id:
          type: string
          description: The unique identifier for this sequence step.
        stepOrder:
          type: integer
          description: An integer indicating the order of this step within the sequence.
          format: int32
        taskPattern:
          $ref: '#/components/schemas/PublicTaskPatternResponseV2'
        updatedAt:
          type: string
          description: >-
            The date and time when this step was last updated, in ISO 8601
            format.
          format: date-time
    Error:
      required:
        - category
        - correlationId
        - message
      type: object
      properties:
        category:
          type: string
          description: >-
            The error category, indicating the general type of error that
            occurred.
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: >-
            Context about the error condition, represented as an object with
            additional properties that are arrays of strings.
          example: >-
            {invalidPropertyName=[propertyValue], missingScopes=[scope1,
            scope2]}
        correlationId:
          type: string
          description: >-
            A unique identifier for the request. Include this value with any
            error reports or support tickets. It is formatted as a UUID.
          format: uuid
          example: aeb5f871-7f07-4993-9211-075dc63e7cbf
        errors:
          type: array
          description: >-
            Further information about the error, represented as an array of
            ErrorDetail objects.
          items:
            $ref: '#/components/schemas/ErrorDetail'
        links:
          type: object
          additionalProperties:
            type: string
          description: >-
            A map of link names to associated URIs containing documentation
            about the error or recommended remediation steps.
        message:
          type: string
          description: >-
            A human readable message describing the error along with remediation
            steps where appropriate.
          example: An error occurred
        subCategory:
          type: string
          description: >-
            A specific category that contains more specific detail about the
            error.
      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
    PublicEmailPatternResponse:
      required:
        - createdAt
        - id
        - templateId
        - updatedAt
      type: object
      properties:
        createdAt:
          type: string
          description: >-
            The date and time when this email pattern was created, in ISO 8601
            format.
          format: date-time
        id:
          type: string
          description: The unique identifier for this email pattern. It is a string.
        templateId:
          type: string
          description: >-
            The identifier of the email template associated with this pattern.
            It is a string.
        threadEmailToStepOrder:
          type: integer
          description: >-
            An integer representing the order of the step to which this email
            pattern is threaded.
          format: int32
        updatedAt:
          type: string
          description: >-
            The date and time when this email pattern was last updated, in ISO
            8601 format.
          format: date-time
    PublicTaskPatternResponseV2:
      required:
        - createdAt
        - id
        - taskPriority
        - taskType
        - updatedAt
      type: object
      properties:
        createdAt:
          type: string
          description: >-
            The date and time when this task pattern was created, in ISO 8601
            format.
          format: date-time
        id:
          type: string
          description: The unique identifier for this task pattern.
        notes:
          type: string
          description: Additional notes or description associated with the task.
        queueId:
          type: string
          description: The identifier for the queue to which this task belongs.
        subject:
          type: string
          description: The subject or title of the task.
        taskPriority:
          type: string
          description: >-
            The priority level of the task, with valid values being 'NONE',
            'HIGH', 'MEDIUM', or 'LOW'.
          enum:
            - HIGH
            - LOW
            - MEDIUM
            - NONE
        taskType:
          type: string
          description: >-
            The type of task, which can be one of the following: 'CALL',
            'MEETING', 'EMAIL', 'TODO', 'LINKED_IN_CONNECT', or
            'LINKED_IN_MESSAGE'.
          enum:
            - CALL
            - EMAIL
            - LINKED_IN_CONNECT
            - LINKED_IN_MESSAGE
            - MEETING
            - TODO
        templateId:
          type: string
          description: The identifier for the template used in this task.
        threadEmailToStepOrder:
          type: integer
          description: >-
            An integer representing the order of the step to which this email
            thread relates.
          format: int32
        updatedAt:
          type: string
          description: >-
            The date and time when this task pattern was last updated, in ISO
            8601 format.
          format: date-time
    ErrorDetail:
      required:
        - message
      type: object
      properties:
        code:
          type: string
          description: >-
            The status code associated with the error detail, indicating the
            type of error encountered.
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: >-
            Context about the error condition, provided as an object with
            additional properties. This can include specific details such as
            missing scopes.
          example: '{missingScopes=[scope1, scope2]}'
        in:
          type: string
          description: >-
            The name of the field or parameter in which the error was found.
            This provides context about where the error occurred.
        message:
          type: string
          description: >-
            A human readable message describing the error along with remediation
            steps where appropriate. This is a required field.
        subCategory:
          type: string
          description: >-
            A specific category that contains more specific detail about the
            error, helping to further classify the error.
  responses:
    Error:
      description: An error occurred.
      content:
        '*/*':
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://app.hubspot.com/oauth/authorize
          tokenUrl: https://api.hubapi.com/oauth/v1/token
          scopes:
            automation.sequences.enrollments.write: ''
            automation.sequences.read: ''
            automation.sequences.write: ''
            sequences-public-delete: ''

````