# Everyone who visited one form

The People list for ONE form: every visit that BEGAN in the window, newest activity first, filed or not — when, for how long, how far they got, the outcome, and the address, device, browser, OS, language and referring site the request showed, plus `submitterLabel` (the record the application filed into, named as you may read it) for a visit that filed. `?outcome=` narrows to submitted, failed_at_submit (pressed submit and never filed), abandoned (touched a question and left) or opened_only; `?window=` is 7d, 30d or 90d (default 7d), the same windows as `get_forms_id_analytics`; `?limit=` (default 50, at most 200) and `?offset=` page it, and `total` counts every match. One application's visit with its event timeline is `get_forms_id_responses_submissionId_visit`.

Access class: `workspace`.

## Endpoint

`GET /v1/forms/{id}/visits`

## Parameters

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

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "data": [
    {
      "submitterLabel": "string"
    }
  ],
  "total": 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"
}
```
