---
title: "Audience eligibility and actionable reasons"
method: GET
path: "/sequences/{sequence_id}/contacts/eligibility/"
tags: ["sequences"]
---

# Audience eligibility and actionable reasons

`GET /sequences/{sequence_id}/contacts/eligibility/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/sequences/{sequence_id}/contacts/eligibility/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Judges the sequence's contacts as the Audience tab counts them: how many were added and checked, how many a step can reach, how many are blocked and why, a sample of contacts per reason, and how many sit under each tab of the roster (In progress, Needs approval, Paused, Done, Blocked). 'capped' says the roster is longer than one read checks. list_sequence_contacts' 'group' lists the contacts under one tab.

## Path parameters

- `sequence_id` string, uuid, required

## Response `200`

Successful Response

- AudienceEligibilityReadSchema
  - `added` integer, required
  - `blocked` integer, required
  - `capped` boolean, required
  - `checked` integer, required
  - `contacts` AudienceEligibilityContactReadSchema[], required
    - `enrolment_id` string, uuid, required
    - `name` string, required
    - `processing` boolean, required
    - `reachable` boolean, required
    - `reason` string, nullable, required
  - `groups` ContactGroupCountsReadSchema, required: How many contacts sit under each of the Audience tab's tabs; they add up to ``checked``.
    - `blocked` integer, required: Cannot go on: no address reaches them, do not contact, in another sequence, contacted too recently, bounced, their mailbox removed, or a step that stopped on an error.
    - `done` integer, required: Nothing left to do: finished, replied, unsubscribed, stopped or removed, or found already connected by a Withdraw.
    - `in_progress` integer, required: Still in the cadence; a draft's roster, which the tab names Not started.
    - `needs_approval` integer, required: A message waiting on the customer's approval.
    - `paused` integer, required: Paused by hand, or in the cadence of a paused sequence.
  - `processing` integer, required
  - `reachable` integer, required
  - `reasons` object, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found.
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)