# Get message delivery quote(s)

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

**GET** `/permissions/quote`

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

Returns pricing information for sending a message to one or more
recipients in a named message box. The caller (sender) is identified by
their auth headers.

**Single-recipient response** uses the legacy shape
`{ status, description, quote: { deliveryFee, recipientFee } }`.

**Multi-recipient response** adds `quotesByRecipient`, `totals`, and
`blockedRecipients` fields. Blocked recipients are still returned in
the list; the caller decides whether to abort or proceed with the
non-blocked subset.

Persisted recipient fees are safe integers from -1 through 2147483647;
server delivery fees are safe integers from 0 through 2147483647.
Invalid persisted values fail the quote closed.

## Authorization

- x-bsv-auth-identity-key (apiKey in header)

## Query parameters

- `recipient` (string, required)
  Identity key of the recipient. Repeat the parameter for multiple
  recipients: `?recipient=A&recipient=B`.
- `messageBox` (string, required)
  Message box type to quote against.

## Responses

### 200

Quote(s) generated.

- `status` ("success", required)
- `description` (string, required)
- `quote` (object, required)
  - `deliveryFee` (integer, required)
    Server delivery fee in satoshis.
  - `recipientFee` (integer, required)
    Recipient-set fee in satoshis (-1 = blocked).

Example:

```json
{
  "status": "success",
  "description": "string",
  "quote": {
    "deliveryFee": 0,
    "recipientFee": 0
  }
}
```

### 400

Missing or invalid parameters.
Codes: `ERR_MISSING_PARAMETERS`, `ERR_INVALID_PUBLIC_KEY`

- `status` ("error", required)
- `code` (string, required)
  Machine-readable error code (see specs/errors.md).
- `description` (string, required)
  Human-readable explanation.

Example:

```json
{
  "status": "error",
  "code": "string",
  "description": "string"
}
```

### 401

Authentication required (`ERR_AUTHENTICATION_REQUIRED`).

- `status` ("error", required)
- `code` (string, required)
  Machine-readable error code (see specs/errors.md).
- `description` (string, required)
  Human-readable explanation.

Example:

```json
{
  "status": "error",
  "code": "string",
  "description": "string"
}
```

### 500

Internal server error (`ERR_INTERNAL`).

- `status` ("error", required)
- `code` (string, required)
  Machine-readable error code (see specs/errors.md).
- `description` (string, required)
  Human-readable explanation.

Example:

```json
{
  "status": "error",
  "code": "string",
  "description": "string"
}
```