List blacklist entries - Autotouch AI

This page documents the canonical HTTP contract for this endpoint.

This endpoint is organization-scoped and requires user_admin. Developer API keys are blocked; use an authenticated user session. The handler catches admin-check exceptions and returns HTTP 500 Failed to fetch blacklist, rather than propagating the expected permission 403. Pagination and search are read-only; unknown query parameters are ignored by FastAPI.

Query parameters

type_filter · optional
string
Exact stored type filter; use all (default), email, or domain.
search · optional
string
Case-insensitive regex search over value, reason, and notes.
page · optional
integer
1-based page number (default: 1).
limit · optional
integer
Page size (default: 100). The route declares no explicit min/max.

Name	Type	Description
type_filter	string	Exact stored type filter; use all (default), email, or domain.
search	string	Case-insensitive regex search over value, reason, and notes.
page	integer	1-based page number (default: 1).
limit	integer	Page size (default: 100). The route declares no explicit min/max.

Errors

Status	Meaning
401	Missing or invalid user session.
403	Developer API keys are blocked; an authenticated user_admin session is required.
422	Invalid query parameter type.
500	List handler returns Failed to fetch blacklist for caught query or admin-check errors.

Example

bash

curl -X GET "https://app.autotouch.ai/api/blacklist?type_filter=domain&page=1&limit=100" \
  -H "Authorization: Bearer $USER_SESSION_TOKEN"

Response example

json

{
  "entries": [
    {
      "id": "67d0afbbdb0e7f3f87f73f55",
      "type": "domain",
      "value": "competitor.com",
      "reason": "competitor",
      "notes": "Partner exclusion list",
      "created_by": "admin@example.com",
      "created_at": "2026-03-05T12:00:00Z",
      "organization_id": "org_123"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 100,
  "pages": 1
}