# List Blocked Providers

> Shared mailbox domains that can't be used

**Endpoint:** `GET /v1/providers/blocked`  
**Access:** Public (no credentials needed)

## cURL example

```bash
curl "https://api.verifiedinbox.ai/v1/providers/blocked"
```

## Responses

### 200 OK

Blocked domains and why.

```json
{
  "data": [
    {
      "category": "free_mailbox",
      "domain": "acme.com",
      "provider": "string"
    }
  ],
  "reason": "Updated company logo"
}
```

### 429 (rate_limited)

`rate_limited` — retry after `Retry-After` seconds (`details.retry_after_seconds`). `limit_reached` — a quota is used up; `details.limit` names it and `next_action` offers support.

```json
{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Please wait a moment and try again."
  }
}
```