> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Remove Subscribers from List

> Remove subscribers from a subscriber list

Remove subscribers from one list by email or subscriber ID. Subscribers are not deleted, they only lose the list membership. You can pass up to 500 targets per request, combined across `emails` and `subscriberIds`.

## Request

<ParamField path="listId" type="string" required>
  Subscriber list ID.
</ParamField>

<ParamField body="emails" type="string[]">
  Email addresses to remove. Emails are trimmed and lowercased. Unknown emails
  are returned in `notFound`.
</ParamField>

<ParamField body="subscriberIds" type="string[]">
  Subscriber IDs to remove.
</ParamField>

Provide at least one of `emails` or `subscriberIds`.

```bash theme={null}
curl -X POST "https://api.sequenzy.com/api/v1/lists/list_abc123/subscribers/remove" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails": ["user@example.com", "unknown@example.com"]}'
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "removed": 1,
    "notFound": ["unknown@example.com"]
  }
  ```

  ```json 400 theme={null}
  {
    "error": "Provide emails or subscriberIds"
  }
  ```

  ```json 400 theme={null}
  {
    "error": "A maximum of 500 subscribers can be removed per request"
  }
  ```

  ```json 401 theme={null}
  {
    "error": "Invalid API key"
  }
  ```

  ```json 404 theme={null}
  {
    "error": "List not found"
  }
  ```
</ResponseExample>