# List all bans

> For the complete documentation index, see [llms.txt](https://bsvblockchain.com/docs/llms.txt).

**GET** `/admin/bans`

Base URL: `https://{fqdn}`

List all bans

## Authorization

- BearerToken (http, bearer)
- BSVMutualAuth (http, bearer)

## Query parameters

- `type` (string)
  Filter by ban type.

## Responses

### 200

List of bans.

- `status` (string, required)
- `data` (object, required)
  - `bans` (object[], required)
    - `type` ("domain" | "outpoint", required)
    - `value` (string, required)
    - `reason` (string)
    - `createdAt` (string<date-time>)

Example:

```json
{
  "status": "string",
  "data": {
    "bans": [
      {
        "type": "domain",
        "value": "string",
        "reason": "string",
        "createdAt": "1970-01-01T00:00:00.000Z"
      }
    ]
  }
}
```

### 401

No authentication credentials provided.

- `status` (string, required)
- `message` (string, required)
- `code` (string)
  Stable machine-readable error code (see specs/errors.md).

Example:

```json
{
  "status": "string",
  "message": "string",
  "code": "string"
}
```

### 403

Credentials provided but insufficient.

- `status` (string, required)
- `message` (string, required)
- `code` (string)
  Stable machine-readable error code (see specs/errors.md).

Example:

```json
{
  "status": "string",
  "message": "string",
  "code": "string"
}
```