---
title: "List Sequence Advanced Analytics Failures"
method: GET
path: "/api/sequences/{sequence_id}/analytics/advanced/failures"
tags: ["sequences"]
---

# List Sequence Advanced Analytics Failures

`GET /api/sequences/{sequence_id}/analytics/advanced/failures`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/sequences/{sequence_id}/analytics/advanced/failures`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

## Path parameters

- `sequence_id` string, required

## Query parameters

- `q` string, nullable
- `failure_category` string, nullable
- `sender_account_id` string, nullable
- `from` string, date-time, nullable
- `to` string, date-time, nullable
- `cursor` string, nullable
- `limit` integer

## Response `200`

Successful Response

- SequenceAdvancedFailuresPagePayload: Cursor page of terminal campaign action failures.
  - `failed_action_count` integer, required: Terminal failed actions across the campaign.
  - `failed_person_count` integer, required: Distinct people with a terminal failure.
  - `failures` SequenceAdvancedFailurePayload[]: Failure rows in this page.
    - `action_name` string, nullable: Failed action name.
    - `contact_company` string, nullable: Current contact company name.
    - `contact_email` string, nullable: Current contact email.
    - `contact_name` string, nullable: Current contact name.
    - `failed_at` string, date-time, required: Time when the terminal failure was recorded.
    - `failure` SequenceAdvancedFailureDetailPayload, required: Sanitized terminal or ambiguous campaign action failure evidence.
      - `blocked_until` string, date-time, nullable: Recipient delivery block expiry, when known.
      - `body_text_length` integer, nullable: Plain-text outbound body length in characters.
      - `bounce_class` string, nullable: Hard, soft, or unknown email bounce class.
      - `category` string, required: Stable failure category used for diagnosis.
      - `email_delivery_provider` string, nullable: Email provider that reported the delivery outcome.
      - `email_delivery_provider_event_id` string, nullable: Provider event id for the delivery evidence.
      - `email_delivery_source` string, nullable: Webhook, sync, or runtime source of the delivery evidence.
      - `evidence_event_id` string, nullable: Durable event supporting the failure classification.
      - `evidence_occurred_at` string, date-time, nullable: Time when the supporting evidence occurred.
      - `linkedin_effective_max_length` integer, nullable: LinkedIn limit applied to this sender and action.
      - `linkedin_effective_max_source` string, nullable: Authority used to select the LinkedIn limit.
      - `linkedin_sender_has_recruiter` boolean, nullable: Whether the sender had Recruiter entitlement.
      - `linkedin_sender_has_sales_navigator` boolean, nullable: Whether the sender had Sales Navigator entitlement.
      - `linkedin_sender_is_premium` boolean, nullable: Whether the sender had LinkedIn Premium entitlement.
      - `provider_boundary_status` string, nullable: Known provider submission state.
      - `provider_error_type` string, nullable: Sanitized provider error category.
      - `reason` string, nullable: Sanitized provider or runtime reason.
      - `recipient_email` string, nullable: Sanitized recipient email associated with delivery failure.
      - `rendered_body_length` integer, nullable: Rendered outbound body length in characters.
      - `smtp_status` string, nullable: Sanitized SMTP status associated with the failure.
    - `instance_id` string, required: Durable campaign runtime instance id.
    - `person_id` integer, required: Internal campaign person id.
    - `person_identifier` string, nullable: Stable sanitized person identity.
    - `runtime_state` string, nullable: Runtime state after the failure.
    - `sender_account_id` string, nullable: Sender account used by the failed action.
    - `step_id` string, required: Workflow step that failed.
    - `step_label` string, nullable: Human-readable failed step label.
    - `variant_id` string, nullable: Action variant that failed.
  - `generated_at` string, date-time, required: Time when the page snapshot was generated.
  - `next_cursor` string, nullable: Opaque cursor for the next page, or null at completion.
  - `sequence_id` string, required: Campaign whose failures were returned.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)