Feedback quickstart
Ask patients one question after a visit and read the practice's Net Promoter Score.
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
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:
{"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
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 or by asking GET /v1/feedback/events. Events carry your own ids,
never a name, an address or a comment.
Full detail: Feedback reference.