# Feedback quickstart

> Ask patients one question after a visit and read the practice's Net Promoter Score.

Source: https://docs.orkero.app/quickstart/feedback

Your system says a visit is done. We ask the patient "How likely are you to recommend us to
a friend or family member?" (0 to 10) by email, at a sensible time, and you read the score.

You need a key with `feedback.signals` and `feedback.figures`.

## 1. Tell us a visit is done

```bash
curl https://api.orkero.app/v1/feedback/signals \
  -H "Authorization: Bearer $ORKERO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "practice_id": "'$PRACTICE'",
    "visit_id": "V-1001",
    "person_id": "P-553",
    "visit_type_name": "Eye examination",
    "contact": {"first_name": "Jane", "email": "jane@example.org"}
  }'
```

`visit_id` and `person_id` are **your own** ids. The answer says what will happen:

```json
{"ok": true, "question": {"state": "scheduled", "send_at": "2026-11-24T12:40:00+00:00"}}
```

Or `not_asked` with a `reason`, such as `asked_recently` or `person_said_no`.

## 2. Read the score

```bash
curl "https://api.orkero.app/v1/feedback/figures?from=2026-09-01&to=2026-11-30" \
  -H "Authorization: Bearer $ORKERO_KEY"
```

`score` runs from −100 to +100. It is `null` until there are enough answers (`min_answers`),
in the total and in every breakdown, so a score never points at one person.

## Rules you cannot switch off

One email per visit and no reminders. No link but the answer page and "don't ask me again".
Sent inside the practice's hours. A person who says "don't ask me again" is never asked
again, whatever you send. The name and email you send are used for that one question and
cleared by the database itself.

## Hear what happened

Each step is an event (`feedback.answer_received`, `feedback.low_score` and more), by
[webhook](/webhooks) or by asking `GET /v1/feedback/events`. Events carry your own ids,
never a name, an address or a comment.

Full detail: [Feedback reference](/reference/feedback).
