---
title: "List inbound-firewall blocked attempts"
method: GET
path: "/v1/mailboxes/{mailboxId}/inbound-allowlist/blocked-attempts"
tags: ["inbound-firewall"]
---

# List inbound-firewall blocked attempts

`GET /v1/mailboxes/{mailboxId}/inbound-allowlist/blocked-attempts`

## Request

- Base URL: `https://api.replylayer.ai`
- URL: `https://api.replylayer.ai/v1/mailboxes/{mailboxId}/inbound-allowlist/blocked-attempts`
- Auth: HTTP bearer

## Path parameters

- `mailboxId` string, required

## Query parameters

- `aggregate` boolean
- `all` boolean
- `cursor` string
- `limit` integer
- `within_days` integer

## Response `200`

Success

- union
  - object
    - `attempts` object[], required
      - `count` integer, required
      - `first_attempted_at` string, required
      - `last_attempted_at` string, required
      - `matched_field` 'envelope' | 'from' | 'null', nullable
      - `mode` 'blocklist' | 'allowlist', required
      - `reason_code` 'SENDER_BLOCKED' | 'SENDER_NOT_ON_ALLOWLIST', required
      - `sender` string, required
    - `next_cursor` string, nullable, required
  - object
    - `attempts` object[], required
      - `attempted_at` string, required
      - `envelope_sender` string, nullable
      - `from_address` string, nullable
      - `matched_field` 'envelope' | 'from' | 'null', nullable
      - `matched_list` 'account_blocklist' | 'mailbox_allowlist' | 'null', nullable
      - `matched_pattern` string, nullable
      - `message_id` string, nullable
      - `mode` 'blocklist' | 'allowlist', required
      - `reason_code` 'SENDER_BLOCKED' | 'SENDER_NOT_ON_ALLOWLIST', required
    - `next_cursor` string, nullable, required

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `429`: Rate limited (code: RATE_LIMITED)
- `500`: Internal error (code: INTERNAL_ERROR)

---

[API](https://skmtc.dev/replylayer/apis/replylayer-api.md) · [All operations](https://skmtc.dev/replylayer/apis/replylayer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/replylayer/apis/replylayer-api/revisions/2cae6fbd127e?raw)
