# List federated domains

Retrieves a paginated list of all domains this instance is federated with, including user counts, availability status, and blocking state. Supports filtering by domain name, availability, and block status.

Endpoint: GET /api/v1/admin/federation
Version: 1.0
Security: 

## Query parameters:

  - `blockState` (array,null)
    Filter by blocking state(s) - accepts single state or comma-separated list (LIMITED, SUSPENDED, NOOP)
    Enum: "SUSPEND", "LIMIT", "NOOP"

  - `lastId` (string,null)
    Get older records (records with IDs less than this value) Alias maxId/max_id
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `limit` (integer,null)

  - `offset` (integer,null)

  - `search` (string,null)
    Filter domains by name

  - `sortBy` (string,null)

  - `sortOrder` (string,null)
    Sort order. Supported values: ASC or DESC

  - `unavailable` (boolean,null)
    Filter only unavailable domains (7+ days not responding)

  - `untilId` (string,null)
    Get newer records (records with IDs greater than this value) Alias minId/min_id
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `warning` (boolean,null)
    Filter only failing domains (1+ days not responding)

## Response 200 fields (application/json):

  - `list` (array, required)

  - `list.domain` (string, required)

  - `list.users` (integer, required)

  - `list.failureDays` (integer, required)
    N of days federation has been unavailable for this domain

  - `list.available` (boolean, required)

  - `list.allowed` (boolean, required)
    Whether it's whitelisted when limited federation mode is on

  - `list.blocked` (string,null, required)
    Registration mode:
      * SUSPEND - removes all content, media, and profile data for this domain's accounts from your server.
      * LIMIT - makes posts from accounts at this domain invisible to anyone who isn't following them.
      * NOOP - when you just want to reject media files or reports.
    Enum: "SUSPEND", "LIMIT", "NOOP"

  - `list.reports` (integer, required)

  - `list.rejectMedia` (boolean,null)
    Whether media files from this domain are rejected

  - `list.rejectReports` (boolean,null)
    Whether reports from this domain are rejected

  - `total` (integer, required)

  - `failureThreshold` (number, required)
    Duration in seconds
    Example: "3600"