---
title: "Retrieve details for a sequence"
method: GET
path: "/automation/v4/sequences/{sequenceId}"
tags: ["Basic"]
---

# Retrieve details for a sequence

`GET /automation/v4/sequences/{sequenceId}`

Retrieve details of a specific sequence by its ID.

## Path parameters

- `sequenceId` string, required

## Query parameters

- `userId` string, required

## Response `200`

successful operation

- PublicSequenceResponse
  - `createdAt` string, date-time, required — The date and time when the sequence was created.
  - `dependencies` PublicSequenceStepDependencyResponse[], required
    - `createdAt` string, date-time, required — The date and time when the step dependency was created.
    - `dependencyType` 'ADAPTIVE_COMPLETION' | 'MANUAL_PAUSE' | 'TASK_COMPLETION', required — The type of dependency between sequence steps with accepted values being TASK_COMPLETION or MANUAL_PAUSE.
    - `id` string, required — The unique identifier of the step dependency.
    - `reliesOnSequenceStepId` string, required — The unique identifier of the sequence step that is responsible for creating and resolving this dependency.
    - `reliesOnStepOrder` integer, required — The order number of the step that is responsible for creating and resolving this dependency.
    - `requiredBySequenceStepId` string, required — The unique identifier of the sequence step that requires this dependency.
    - `requiredByStepOrder` integer, required — The order number of the step that requires this dependency.
    - `updatedAt` string, date-time, required — The date and time when the step dependency was last updated.
  - `folderId` string — The identifier of the folder containing the sequence.
  - `id` string, required — The unique identifier for the sequence.
  - `name` string, required — The name of the sequence.
  - `settings` PublicSequenceSettingsResponse
    - `createdAt` string, date-time, required — The timestamp of when the sequence settings were created.
    - `eligibleFollowUpDays` 'BUSINESS_DAYS' | 'EVERYDAY' | 'WEEKDAYS_ONLY', required — Specifies the days on which follow-up actions are allowed.
    - `id` string, required — The unique identifier for the sequence settings.
    - `individualTaskRemindersEnabled` boolean, required — Indicates whether individual task reminders are enabled.
    - `sellingStrategy` 'ACCOUNT_BASED' | 'LEAD_BASED', required — (deprecated) Defines the unenrollment strategy, with accepted values being ACCOUNT_BASED or LEAD_BASED. If ACCOUNT_BASED is used, all contacts associated with the same company will be unenrolled if one contact meets any of the unenrollment criteria.
    - `sendWindowEndMinute` integer, required — Indicates the end minute of the time window during which automated emails can be sent.
    - `sendWindowStartMinute` integer, required — Indicates the start minute of the time window during which automated emails can be sent.
    - `taskReminderMinute` integer, required — Specifies the minute of day at which task reminders are triggered.
    - `updatedAt` string, date-time, required — The timestamp of when the sequence settings were last updated.
  - `steps` PublicSequenceStepResponse[], required
    - `actionType` 'ADAPTIVE_CONTAINER' | 'EMAIL' | 'FINISH_ENROLLMENT' | 'TASK', required — The type of action to be performed in the sequence step.
    - `createdAt` string, date-time, required — The date and time when the sequence step was created.
    - `delayMillis` integer, required — The delay in milliseconds before the sequence step is executed.
    - `emailPattern` PublicEmailPatternResponse
      - `createdAt` string, date-time, required — The date and time when the email pattern was created.
      - `id` string, required — The unique identifier of the email pattern.
      - `templateId` string, required — The unique identifier of the email template associated with the pattern.
      - `threadEmailToStepOrder` integer — The order identifying the previous step to which the email thread is linked.
      - `updatedAt` string, date-time, required — The date and time when the email pattern was last updated.
    - `id` string, required — The unique identifier of the sequence step.
    - `stepOrder` integer, required — The order of the step within the sequence.
    - `taskPattern` PublicTaskPatternResponse
      - `createdAt` string, date-time, required — The date and time when the task pattern was created.
      - `id` string, required — The unique identifier for the task pattern.
      - `notes` string — Additional notes or comments associated with the task.
      - `queueId` integer — The identifier for the queue associated with the task.
      - `subject` string — The subject line of the task.
      - `taskPriority` 'HIGH' | 'LOW' | 'MEDIUM' | 'NONE', required — The priority level assigned to the task.
      - `taskType` 'CALL' | 'EMAIL' | 'LINKED_IN_CONNECT' | 'LINKED_IN_MESSAGE' | 'MEETING' | 'TODO', required — The type of task, such as an email or call.
      - `templateId` integer — The identifier for the template used in the task.
      - `threadEmailToStepOrder` integer — The order of the step to which the email thread is related.
      - `updatedAt` string, date-time, required — The date and time when the task pattern was last updated.
    - `updatedAt` string, date-time, required — The date and time when the sequence step was last updated.
  - `updatedAt` string, date-time, required — The date and time when the sequence was last updated.
  - `userId` string, required — The ID of the user associated with the sequence.

## Other responses

- `default` — An error occurred.

## Changes

- **2026-08-15** (v4) `1eeb2fde6883` — 1 info
  - endpoint added
- **2026-07-13** (v4) `9806ae62d2f1` — 1 breaking
  - api path removed without deprecation
- **2026-05-22** (v4) `4437b130c791` — 2 info
  - the security scope `automation.sequences.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `sequences-public-read-access` was removed from the endpoint's security scheme `oauth2`
- **2026-04-21** (v4) `ef6694207fbc` — 1 breaking
  - the `steps/items/delayMillis` response's property type/format changed from `integer`/`int32` to `integer`/`int64` for status `200`
- **2026-04-15** (v4) `f02323380ddf` — 4 info
  - the endpoint scheme security `app_cookie` was removed from the API
  - the endpoint scheme security `hapikey` was removed from the API
  - the endpoint scheme security `internal_cookie` was removed from the API
  - the endpoint scheme security `shhkey` was removed from the API

[Full history](https://skmtc.dev/hubspot/apis/automation-sequences/changes/automation/v4/sequences/:sequenceId/get.md)

---

[API](https://skmtc.dev/hubspot/apis/automation-sequences.md) · [All operations](https://skmtc.dev/hubspot/apis/automation-sequences/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hubspot/automation-sequences/revisions/1eeb2fde6883/schema)
