# Preview how a blast will land

How a blast will land BEFORE it is sent, counted over its whole audience and rendered by the same function the send uses — read it after aiming a blast and before dispatching it. It answers `wouldSend`, how many resolve every field from its first choice (`clean`) or from a fallback (`fellBack`), how many would be skipped and why (`unresolved`: a field with nothing to fill it and no fallback; `empty`; `optedOut`), every field the words use with how many recipients can fill it (`fields`), up to `limit` (default 5, at most 25) real `samples` with the troubled ones first, and `problems` — sentences to fix before sending: a malformed field, a field nobody in the audience has, recipients who would be skipped, a missing goal. It sends nothing and changes nothing. Each sample's `subject` and `body` are that recipient's message as the dispatch writes it, fields filled — the copy to show a person reviewing the blast, never the `{{…}}` source.

Access class: `workspace`.

## Endpoint

`GET /v1/blasts/{id}/preview`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| id | path | string | Yes |
| limit | query | integer | No |

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "audience": 1,
    "blastId": 1,
    "bodyFormat": "string",
    "clean": 1,
    "empty": 1,
    "fellBack": 1,
    "fields": [
      {
        "filled": "string",
        "missing": "string",
        "name": "string"
      }
    ],
    "goal": "string",
    "kind": "string",
    "optedOut": 1,
    "problems": [
      "string"
    ],
    "samples": [
      {
        "address": "string",
        "body": "string",
        "bodyFormat": "string",
        "displayName": "string",
        "fellBack": "string",
        "skipped": "string",
        "subject": "string",
        "unresolved": "string"
      }
    ],
    "status": "string",
    "unresolved": 1,
    "wouldSend": 1
  }
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```
