---
title: "List sequences created within Recruiterflow."
method: POST
path: "/api/external/sequences/list"
tags: ["Sequence APIs"]
---

# List sequences created within Recruiterflow.

`POST /api/external/sequences/list`

<br/>Returns a paginated, filterable list of sequences with per-sequence<br/>performance `stats` and a `recipient_status` breakdown.<br/><br/>Pagination is required: `current_page` is 1-based and `items_per_page` may be<br/>at most 100.<br/><br/>Optional `filters` is a list of objects. Supported keys (valid ids come from<br/>the `/api/external/sequences/reference-data` endpoint):<br/>  - `status` (values: list of status ids)<br/>  - `sequence_type_ids` (values: list of sequence type ids)<br/><br/>Optional `q` searches by sequence name. Optional `sort` is an object with<br/>`on` (one of `sequence_name`, `sequence_type`, `sequence_status`, `created_at`)<br/>and `order` (`ASC` or `DESC`); it defaults to newest first.<br/>

## Headers

- `RF-Api-Key` string, required
- `content-type` string

## Request body

- object
  - `current_page` integer, required — 1-based page number.
  - `filters` object[] — Optional list of filter objects.
    - `key` string
    - `values` integer[]
  - `items_per_page` integer, required — Records per page (maximum 100).
  - `q` string — Optional case-insensitive search on the sequence name.
  - `sort` object
    - `on` string
    - `order` string

## Response `200`

Paginated list of sequences

- unknown

## Other responses

- `400` — Invalid pagination parameters

## Changes

- **2026-08-13** `febc104d89ff` — 1 breaking
  - the `header` request parameter `RF-Api-Key` became required

[Change history](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation/changes/api/external/sequences/list/post.md)

---

[API](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation.md) · [All operations](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recruiterflow/recruiterflow-api-documentation/revisions/febc104d89ff/schema)