---
title: "sequence.info"
method: POST
path: "/sequence.info"
tags: ["Sequence"]
---

# sequence.info

`POST /sequence.info`

> Beta
>
> This endpoint is in beta and may not be available for all organizations.

Retrieves a candidate's sourcing sequence enrollment when it is visible to the acting user.

Not-started email stages include resolved, editable subject and HTML body content. Started sequences return stage metadata without message content. Drafts are visible only to the acting user who created them, so requests made with x-on-behalf-of must continue using the same user.

Returns sequence_not_found for missing, inaccessible, or non-sourcing sequences.

**Requires the [`sourcingRead`](authentication#permissions-sequenceinfo) permission.**

## Request body

- SequenceInfoRequest
  - `sequenceId` string, uuid, required — The unique identifier for the sequence enrollment

## Response `200`

Responses from the sequence.info endpoint

- union
  - SequenceInfoSuccessResponse
    - `success` true, required
    - `results` Sequence, required
      - `id` string, uuid, required — The unique identifier for this candidate's sequence enrollment
      - `candidateId` string, uuid, required — The candidate enrolled in the sequence
      - `applicationId` string, uuid, nullable, required — The application selected for token resolution, when one is available
      - `sequenceTemplateId` string, uuid, required — The reusable sequence template used for enrollment
      - `status` 'NotStarted' | 'Running' | 'Paused' | 'Completed' | 'Cancelled' | 'Unsubscribed', required
      - `createdAt` string, date-time, required — When the sequence enrollment was created
      - `stages` SequenceStage[], required — The stages in sequence order
        - `id` string, uuid, required — The unique identifier for this sequence stage
        - `type` 'Email' | 'InMail' | 'LinkedInConnection', required
        - `from` SequenceSender
          - `email` string, email, required — The address used to send this stage
          - `displayName` string, nullable, required — The sender display name configured by Ashby, when one is available
        - `subject` string — The resolved subject for an editable, not-started email stage
        - `bodyHtml` string — The editable HTML body for a not-started email stage. Ashby token markers must be preserved when editing.
        - `sendAfter` union, required — The delay before this stage is sent
          - object
            - `kind` 'NoDelay', required
          - object
            - `kind` 'AtDateAndTime', required
            - `dateTime` string, date-time, required — The absolute date and time when the stage is sent
            - `timezone` string, required — The IANA timezone used for the scheduled date and time
          - object
            - `kind` 'TimeIntervalElapsed', required
            - `amount` integer, required — The number of delay units to wait after the previous stage
            - `unit` 'day' | 'week' | 'month' | 'quarter' | 'year', required — The unit for the elapsed delay
            - `time` string, required — The local send time in 24-hour HH:mm format
            - `timezone` string, required — The IANA timezone used for the local send time
            - `allowedWeekdays` integer[], required — Allowed send weekdays using ISO numbering, where Monday is 1 and Sunday is 7
  - ErrorResponse
    - `success` false, required
    - `errors` ErrorDetail[], required
      - `message` string, required
      - `parameter` string

---

[API](https://skmtc.net/ashbyhq/apis/ashby-api.md) · [All operations](https://skmtc.net/ashbyhq/apis/ashby-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ashbyhq/ashby-api/revisions/778b919dc743/schema)