Cancel a registration
Cancelling looks like one field, status: canceled, but it can do more:
- cancel the client's unused make-up credits;
- affect the other registrations booked together with this one;
- move money;
- email the client.
This guide uses the preflight check to find out what a cancellation would do, ask the user what it needs, and then apply it:
- Check the cancellation.
- Make-up credits: how many the client keeps.
- Registrations booked together: what happens to the group.
- Email and date: whether the client hears about it, and when it happens.
- Apply.
Every request and answer from a recorded call is marked as an example. Names, emails and other personal data are replaced.
Before you start
- A key with
core_readandcore_write. The check and the cancellation each cost 5 points. See Access and rate limits. - The registration's id. See Find registrations.
- The token from Authentication, sent as
Authorization: Bearer <token>.
Both calls are PUT /v3/registrations/{ID} with the body
action: change_status. Change a registration explains why that body must carry
nothing else.
1. Check the cancellation
Send the cancellation with ?action=preflight_check. A cancellation needs a reason: cancellation_reason, one of
the values the reference lists (for example personal_default or not_paid_default), or cancellation_reason_id,
one of the company's own reasons.
Checking a cancellation (reference)
PUT /v3/registrations/168321?action=preflight_check
{
"action": "change_status",
"status": "canceled",
"cancellation_reason": "personal_default"
}
Answer: 200
Answer body (200)
{
"checks": {
"rules_hold": {
"name": "rules_hold",
"result": "passed",
"severity": "error"
},
"decision_missing": {
"name": "decision_missing",
"result": "passed",
"severity": "error"
},
"money_moves": {
"name": "money_moves",
"result": "passed",
"severity": "notice"
},
"transferred_money_stays": {
"name": "transferred_money_stays",
"result": "passed",
"severity": "notice"
},
"currency_conversion": {
"name": "currency_conversion",
"result": "passed",
"severity": "notice"
},
"status_allowed": {
"name": "status_allowed",
"result": "passed",
"severity": "error"
}
},
"properties": {
"result": {
"name": "result",
"value": {
"booking": {
"type": "registration",
"id": 168321
},
"root": {
"type": "registration",
"id": 168321
},
"limits": {
"max_depth": 3,
"truncated": false
},
"members": [
{
"type": "registration",
"id": 168321,
"summary": {
"name": "Ballet basics",
"client_name": "Anna Novak",
"course": {
"id": 990,
"name": "Kids gymnastics"
},
"schedule": {
"id": 6779,
"name": "Tuesday 17:00"
},
"product": null,
"status": "registered",
"trial": false,
"balance": -110,
"currency": "EUR"
},
"parent": null,
"paid_by": null,
"pays_for": [],
"previous": null,
"next": null
}
],
"related": []
}
},
"transfers": {
"name": "transfers",
"value": []
},
"balances": {
"name": "balances",
"value": []
},
"refusals": {
"name": "refusals",
"value": []
},
"options": {
"name": "options",
"value": {}
},
"replacement_credits": {
"name": "replacement_credits",
"value": {
"available": 0,
"replacement": 0,
"replacement_transfer": 0
}
}
}
}
The checks of a status change. The reference doesn't describe them per check yet, so this table describes how they behave today:
| Check | Severity | Not passed means |
|---|---|---|
status_allowed | error | The registration can't go from its current status to this one. |
rules_hold | error | The change would break a rule about registrations booked together. refusals says which. |
decision_missing | error | The change needs a decision you haven't sent: what happens to the group (step 3). |
replacement_conversion_count | error | Only when you send convert_replacements_to_free_event: the number isn't a whole number from 0 to the make-up credits available (step 2). |
money_moves | notice | Money would move between registrations. transfers lists the movements. |
transferred_money_stays | notice | Money moved earlier stays where it is; it doesn't move back. |
currency_conversion | notice | A movement would convert between currencies. |
The properties:
| Property | What it holds |
|---|---|
result | The registrations involved, as they would be after the change. members lists each with a summary (client, programme, class, status, balance, currency). |
replacement_credits | On a cancellation only: the client's unused, unexpired make-up credits from this registration (step 2). |
refusals | Why an error check failed: the check, the booking concerned and, when a decision would solve it, its options. |
options | Every choice the change offers, in the same shape as a refusal's options. {} when there's nothing to choose. |
transfers | The money movements the change would make. |
balances | Each affected registration's balance after the change. |
A registration that isn't in a group passes every check about groups, and options is {}.
Without a reason, the check itself is refused, with a 400 0338:
Checking a cancellation without a reason (reference)
PUT /v3/registrations/168321?action=preflight_check
{
"action": "change_status",
"status": "canceled"
}
Answer: 400
{
"errors": [
{
"0338": "Choose a cancellation reason."
}
],
"request_valid": false
}
2. Make-up credits
When a client misses a session in time, they can earn a make-up credit (see How make-up sessions work). Cancelling the registration cancels every make-up credit the client still has from it, unless you say how many to keep as free sessions.
properties.replacement_credits shows what the client has:
{ "available": 2, "replacement": 2, "replacement_transfer": 0 }
available is the total, split into the two kinds of make-up credit. With available: 0 there's nothing to ask.
Otherwise, ask before you cancel:
This registration has 2 unused make-up credits. Cancelling it cancels them too. How many should the client keep as free sessions? (0–2)
Send the answer as convert_replacements_to_free_event. To validate the number first, include it in the check:
replacement_conversion_count then says whether it's valid.
- Which credits are kept: the ones that expire last.
- The rest: cancelled together with the registration. Either all of it happens or none of it.
- Without the field, or with
0: every credit is cancelled. - On apply: the number is checked against the credits available then, so it fails if the client has used one in the meantime.
There's no other /v3 call that lists a registration's make-up credits. The check is the way to know.
3. Registrations booked together
Registrations can be booked together, for example siblings in one booking, or a trial with the products bought with it. A group has one main registration, which may pay for the others.
Cancelling any other registration in the group changes nothing about the group. The checks pass and options is
{}.
Cancelling the main registration needs a decision. Without it, decision_missing fails, and refusals and
options list the choices:
| Choice | What happens |
|---|---|
new_root | Another registration of the group becomes the main one. options.new_root lists the registrations that can. The cancelled registration's money moves to the new main one, unless options offers keep_balance and you choose it. |
whole_group | Every registration in the group is cancelled with it. |
disband | The group stops existing, and each registration pays for itself. Optionally, transfer_balance_to (one of options.transfer_balance_to) receives the cancelled registration's remaining balance. |
Send the choice in linking, next to status, both in the check and when you apply:
{
"action": "change_status",
"status": "canceled",
"cancellation_reason": "personal_default",
"linking": { "resolution": "new_root", "new_root": { "type": "registration", "id": 50715 } }
}
Check again with the decision in. decision_missing then passes, and transfers and balances show what the choice
does to the money. Show that to the user before you apply.
4. Email and date
Email. Zooza emails the client only if you ask:
send_confirmationemails a cancellation confirmation whatever its value,falseincluded. To send no email, leave the key out.emailsends your own message, but only when it hassubject,bodyandtemplate.
The check doesn't say whether an email would go: that depends only on these two fields.
Date. Without schedule_at, the registration is cancelled now. With schedule_at: "YYYY-MM-DD", it is cancelled
on that date, but some of it is decided when you schedule it:
- the make-up credits are handled at once: kept as free sessions or cancelled;
- the group decision (step 3) is applied at once;
- only the status waits for the date.
The check works the same for a scheduled cancellation. To call a scheduled cancellation off, send
action: revoke_scheduled_status_change. That doesn't bring back make-up credits that were already cancelled.
5. Apply
Send the same body without ?action=preflight_check, with the decisions from steps 2 to 4 added. The answer is the
registration with its new status.
Applying the cancellation (reference)
PUT /v3/registrations/168321
{
"action": "change_status",
"status": "canceled",
"cancellation_reason": "personal_default"
}
Answer: 200
Answer body (200)
{
"id": 168321,
"company_id": 1,
"course_id": 990,
"schedule_id": 6779,
"event_id": 0,
"user_id": 65604,
"slots": 1,
"billing_period_id": 268,
"parent": 0,
"total_events": 0,
"status": "canceled",
"business_order": false,
"created": "2026-11-20 18:21:34",
"updated": "2026-11-21 15:36:41",
"note": "",
"company_note": "Called on Monday\nwill pay on Friday",
"public_note": null,
"payment_method": "cash",
"notify": true,
"paid": 0,
"payment_status": "awaiting_payment",
"value": 110,
"preferred_payment_schedule": 0,
"__users__full_name": "Anna Novak",
"__users__phone": "+421900000002",
"__users__email": "client2@example.com",
"__calc__debt": -110,
"__calc__paid": 0,
"__calc__balance": -110,
"notify_about_upcoming_events": true,
"notify_alternate_email": null,
"notify_alternate_email_only": false,
"guest_id": 0,
"__calc__guest_email": null,
"__calc__guest_user_id": 0,
"__calc__guest_notify": false,
"attendance_management": "default",
"extra_replacements_limit": 0,
"payments_managed_by": 0,
"iban": null,
"swift": null,
"invoice_profile": 0,
"origin": "widget",
"__courses__name": "Kids gymnastics",
"__courses__get_extra_fields_from": "all",
"__schedules__name": "Tuesday 17:00",
"offline_charge_available": false,
"__users__first_name": "Anna",
"__users__last_name": "Novak",
"vat_level": 0,
"payment_schedule_id": 0,
"__calc__order_summary": "(HTML left out of the example)",
"trial_started": "2026-11-20 18:21:34",
"trial_ended": null,
"trial_lost": null,
"trial_won": null,
"booking_link_sent": null,
"first_followup_sent": null,
"second_followup_sent": null,
"trial_lost_confirmation_sent": null,
"__events__first_event": "",
"process_course_trial_automation": true,
"currency": null,
"currency_rate": 0,
"__extra_fields__full_name": "Anna Novak",
"downpayment": 0,
"downpayment_due": null,
"__calc__buyer_person_id": 56072,
"__calc__customer_person_id": 56072,
"retention_notification_sent": null,
"in_retention": false,
"next": 0,
"previous": 0,
"status_change_scheduled_at": null,
"scheduled_status": null,
"trial_ends": "2026-12-29 16:00:00",
"after_trial_course_id": 0,
"after_trial_schedule_id": 0,
"iban_account_holder": null,
"__calc__has_segments": false,
"awaiting_payment_until": "2026-11-30",
"awaiting_payment_reason": 0,
"awaiting_payment_source": "default",
"awaiting_payment_note": null,
"__calc__has_payment_schedule": false,
"__calc__has_any_payment_schedule": false,
"__payment_schedules_templates__name": null,
"__calc__scheduled_payments__total_payments": 0,
"__calc__scheduled_payments__processed_payments": 0,
"__calc__scheduled_payments__next_payment": null,
"__calc__scheduled_debt": 0,
"__calc__current_value": -110,
"__calc__additional_debt": 0,
"__calc__additional_balance": 0,
"deleted_at": null,
"deleted_by_user_id": 0,
"status_before_delete": null,
"__calc__unpaid_since": null,
"__calc__payments__last_received_at": null,
"cancellation_reason": "personal_default",
"nudge_state": "active",
"cancellation_reason_id": null,
"canceled_by_user_id": 37,
"__calc__remaining_events": 0,
"cancellation_category": "personal",
"cancellation_reason_label": null,
"canceled_by_name": "Kowalski1 Kowalski1",
"canceled_at": "2026-11-21 15:36:41",
"extra_fields": {
"full_name": "Anna Novak",
"id": 43591,
"registration_id": 168321,
"dob": "0000-00-00",
"address": "1 Example Street, Example Town",
"address_structured": [],
"business_name": "",
"business_address": "",
"business_id": "",
"tax_id": "",
"vat": "",
"created": "2026-11-20 18:21:34",
"updated": "2026-11-20 18:21:34",
"identification_number": "",
"extra_field_1": "",
"extra_field_2": "",
"extra_field_3": "",
"extra_field_4": "",
"extra_field_5": "",
"extra_field_6": "",
"extra_field_7": "",
"extra_field_8": "",
"extra_field_9": "",
"extra_field_10": "",
"extra_field_11": "",
"extra_field_12": "",
"extra_field_13": "",
"extra_field_14": "",
"extra_field_15": "",
"citizenship": null
},
"schedule": {
"id": 6779,
"course_id": 990,
"time": 631,
"duration": 60,
"place_id": 3,
"room_id": 0,
"trainer_id": 9000000000001,
"registrations_cap": 0,
"capacity": 10,
"extra_capacity": 0,
"total_events": 42,
"type": "weekly",
"name": "Tuesday 17:00",
"start": "2025-09-10",
"end": "2026-12-29",
"extra_capacity_usage": "add",
"status": "active",
"public": true,
"online_registration": true,
"price": 0,
"registration_fee": 0,
"note": null,
"notify_trainer_on_cancellation": "never",
"__calc__total_avg_nps_score": 0,
"__calc__total_requests": 0,
"__calc__registered": 8,
"__calc__waitlist": 0,
"__calc__late": 0,
"trainer_rate_type_id": 0,
"billable_events": 0,
"__calc__events__elapsed": 31,
"__calc__events__total": 42,
"__calc__events__total_custom_replacements": 0,
"__calc__events__total_billable": 0,
"__calc__events__elapsed_billable": 0,
"__calc__events__total_scheduled": 42,
"__calc__events__total_unplanned": 0,
"__calc__events__total_nonbillable": 42,
"__courses__billable_events": 0,
"__calc__possible_income": 0,
"__calc__booked_income": 0,
"__calc__debt_issued": 0,
"__calc__debt_paid": 0,
"__calc__debt_balance": 0,
"__calc__debt_updated": null,
"__calc__nps_promoters": 0,
"__calc__nps_detractors": 0,
"__calc__nps": 0,
"unit_price": 0,
"__calc__price": 420,
"__courses__unit_price": 10,
"__courses__price": 10,
"__courses__registration_fee": 0,
"__courses__price_type": "membership",
"__courses__registration_type": "full2",
"__calc__unit_price": 10,
"__calc__registration_fee": 0,
"__calc__current_price": 110,
"__calc__min_age": 0,
"__calc__max_age": 2000,
"in_trial": true,
"__calc__trial_started": 0,
"__calc__trial_not_started": 0,
"__calc__trial_ended": 0,
"__calc__trial_won": 0,
"__calc__trial_lost": 0,
"__calc__segments": 0,
"apply_segment_discount": 0,
"segment_discount_multiplier": 0,
"__calc__registration_url": "https://booking.example.com/test123/registration?schedule_id=6779&course_id=990&place_id=3_0",
"schedule_type": "fixed_period",
"in_retention": false,
"custom_start": false,
"custom_end": false,
"lead_collection_money_collection_enabled": false,
"segments_config": null,
"online_meeting_id": null,
"online_meeting_provider": null,
"all_day": false,
"__courses__money_collection": "installments",
"__courses__schedule_start_date_format": null,
"__courses__schedule_end_date_format": null,
"description": null,
"deleted_at": null,
"deleted_by_user_id": 0,
"status_before_delete": null,
"__calc__has_shared_sessions": 0,
"__calc__effective_capacity": 10,
"company_id": 1,
"priority_registration": true,
"priority_registration_phase": null,
"__view__admin_url": "https://app.example.com/#courses/schedules/6779",
"__view__registration_url_active": true,
"glue_set_id": 0,
"__view__priority_registration_start": null,
"__view__priority_registration_public_start": null
},
"course": {
"id": 990,
"company_id": 1,
"created": "2025-08-12 10:17:47",
"name": "Kids gymnastics",
"url": "",
"price": 10,
"registration_fee": 0,
"cash": true,
"direct_debit": false,
"direct_debit_provider": "manual",
"online_card": true,
"online_transfer": false,
"fees_included_in_price": true,
"public": true,
"archive": false,
"online_registration": true,
"on_behalf": false,
"feedback_during_course": true,
"feedback_after_course": true,
"get_extra_fields_from": "all",
"get_basic_fields_from": "registrant",
"registration_type": "full2",
"course_type": "course",
"registration_slots_min": 1,
"registration_slots_max": 3,
"registration_open": 0,
"show_on_site": 0,
"hide_if_full": false,
"allow_replacements": true,
"allow_custom_replacements": false,
"auto_approve_custom_replacements": false,
"allow_cancel_until": 0,
"allow_replacements_waitlist": false,
"waitlist": "",
"auto_waitlist_notification": false,
"description": null,
"use_extra_fields": true,
"for_children": false,
"replacements_limit": 6,
"replacements_settings": {
"courses": "all",
"billing_periods": "all",
"places": "all"
},
"theme": null,
"custom_email": 0,
"custom_email_event_notification": 0,
"event_notification": true,
"late_registrations": "auto_approve",
"allow_registration_after_end": false,
"custom_label_note": null,
"hide_before": 0,
"collect_feedback_start": "2025-05-01",
"iban": "SK0000000000000000000000",
"swift": null,
"custom_label_first_name": null,
"custom_label_last_name": null,
"custom_label_phone": null,
"custom_label_email": null,
"upcoming_events_notification": false,
"__calc__fee_cash": 1,
"__calc__fee_online_card": 0.69,
"__calc__fee_direct_debit": 0,
"__calc__fee_online_transfer": 0.5,
"allow_replacement_cancellation": false,
"admin_managed_replacements": false,
"allow_guest_registrations": false,
"color": "none",
"allow_replacements_from_other_companies": true,
"replacements_settings_other_companies": {
"type": "selection",
"billing_periods": "all",
"schedules": "all",
"places": "all",
"companies": [
2,
6
]
},
"payment_schedule_is_mandatory": true,
"allow_using_replacement_credits_as_discount": false,
"replacements_limit_per_events": 0,
"flexible_replacements_limit": false,
"online_card_provider": "stripe_connect",
"online_transfer_provider": "besteron",
"allow_reschedule_of_replacements": true,
"payments_managed_by_buyer": false,
"billable_events": 0,
"replacement_time_limit": 0,
"replacement_time_limit_type": "after",
"unit_price": 10,
"price_type": "membership",
"always_use_total_price": false,
"__calc__price": 10,
"direct_debit_mandate_id_format": null,
"default_email_signature": 0,
"aliquot_settings": "automatic",
"track_attendance": true,
"custom_email_lead": 0,
"constant_symbol": 0,
"specific_symbol": 0,
"money_collection": "installments",
"trial_events_limit": 4,
"trial_events_capacity": "all",
"trial_events_limit_type": "count",
"trial_type": "free_trial",
"code": null,
"__calc__available_currencies": [],
"downpayment": "none",
"downpayment_due_type": "before_course",
"downpayment_due_days": 15,
"downpayment_value": 0,
"downpayment_cap": 0,
"__calc__registration_url": "https://booking.example.com/test123/registration?course_id=990",
"force_full_first_installment": false,
"retention_settings": [],
"retention_type": "duplicate_schedule",
"retention_notify_days_before": 1,
"__calc__schedules_count": 13,
"__calc__registrations_count": 36,
"widgets_published": false,
"allow_rescheduling_of_events": false,
"auto_approve_rescheduled_events": false,
"limit_reschedule_to_once": false,
"__calc__min_age": 0,
"__calc__max_age": 0,
"trial_length": 1,
"trial_length_type": "days",
"automatically_add_schedules_to_trial": true,
"automatically_add_schedules_to_retention": false,
"unit_price_trial": 8,
"registration_display_mode": "segments_only",
"target_audience": "groups",
"onboarding": {
"version": 1,
"price": false,
"trial": false,
"online_registration": false,
"replacements": false,
"extra_fields": false,
"attendance": false
},
"iban_account_holder": "Example Ltd",
"reserve_seat_for_trial_attendees": true,
"require_valid_entrance_voucher": false,
"payment_mode": "pass_first",
"priority": 0,
"retention_message": null,
"retention_days": 0,
"deleted_at": null,
"reviews_after_registration": false,
"reviews_after_first_session": false,
"reviews_after_class_ended": true,
"collect_reviews_start": null,
"delayed_start_max_days": 0,
"priority_registration": false,
"priority_registration_allow_multiple": false,
"priority_registration_offset": null,
"priority_registration_public_offset": null,
"priority_registration_audience": [],
"allow_additional_sessions": false,
"additional_sessions_settings": [],
"additional_session_pricing_mode": "regular_unit_price",
"additional_session_unit_price": 0,
"additional_sessions_limit": 0,
"additional_session_payment_mode": "open",
"additional_session_payment_deadline_days": 7,
"allow_cancellation_discount": false,
"schedule_start_date_format": null,
"schedule_end_date_format": null,
"schedule_defaults": {
"state": "undecided",
"values": {}
},
"direct_debit_scheme": "sepa",
"direct_debit_mandate_id_rules": {
"scheme": "sepa",
"max_length": 35,
"charset": "A-Za-z0-9\\/\\-?:().,'+ ",
"charset_label_key": "mandate_id_charset_help__sepa",
"no_leading_space": false,
"not_all_identical": false,
"tokens": [
{
"token": "{C}",
"label_key": "mandate_id_token__company_raw"
},
{
"token": "{c}",
"label_key": "mandate_id_token__company_padded"
},
{
"token": "{P}",
"label_key": "mandate_id_token__programme_raw"
},
{
"token": "{p}",
"label_key": "mandate_id_token__programme_padded"
},
{
"token": "{O1}…{O10}",
"label_key": "mandate_id_token__order_number"
},
{
"token": "{I1}…{I10}",
"label_key": "mandate_id_token__increment"
}
]
},
"direct_debit_mandate_id_rules_by_provider": {
"manual": {
"scheme": "sepa",
"max_length": 35,
"charset": "A-Za-z0-9\\/\\-?:().,'+ ",
"charset_label_key": "mandate_id_charset_help__sepa",
"no_leading_space": false,
"not_all_identical": false,
"tokens": [
{
"token": "{C}",
"label_key": "mandate_id_token__company_raw"
},
{
"token": "{c}",
"label_key": "mandate_id_token__company_padded"
},
{
"token": "{P}",
"label_key": "mandate_id_token__programme_raw"
},
{
"token": "{p}",
"label_key": "mandate_id_token__programme_padded"
},
{
"token": "{O1}…{O10}",
"label_key": "mandate_id_token__order_number"
},
{
"token": "{I1}…{I10}",
"label_key": "mandate_id_token__increment"
}
]
},
"go_cardless": {
"scheme": "sepa",
"max_length": 35,
"charset": "A-Za-z0-9\\/\\-?:().,'+ ",
"charset_label_key": "mandate_id_charset_help__sepa",
"no_leading_space": false,
"not_all_identical": false,
"tokens": [
{
"token": "{C}",
"label_key": "mandate_id_token__company_raw"
},
{
"token": "{c}",
"label_key": "mandate_id_token__company_padded"
},
{
"token": "{P}",
"label_key": "mandate_id_token__programme_raw"
},
{
"token": "{p}",
"label_key": "mandate_id_token__programme_padded"
},
{
"token": "{O1}…{O10}",
"label_key": "mandate_id_token__order_number"
},
{
"token": "{I1}…{I10}",
"label_key": "mandate_id_token__increment"
}
]
},
"fastpay": {
"scheme": "bacs",
"max_length": 18,
"charset": "A-Z0-9 &.\\-\\/",
"charset_label_key": "mandate_id_charset_help__bacs",
"no_leading_space": true,
"not_all_identical": true,
"tokens": [
{
"token": "{C}",
"label_key": "mandate_id_token__company_raw"
},
{
"token": "{c}",
"label_key": "mandate_id_token__company_padded"
},
{
"token": "{P}",
"label_key": "mandate_id_token__programme_raw"
},
{
"token": "{p}",
"label_key": "mandate_id_token__programme_padded"
},
{
"token": "{O1}…{O10}",
"label_key": "mandate_id_token__order_number"
},
{
"token": "{I1}…{I10}",
"label_key": "mandate_id_token__increment"
}
]
}
}
},
"buyer": {
"id": 56072,
"user_id": 65604,
"first_name": "Anna",
"last_name": "Novak",
"created": "2026-11-20 18:21:20",
"updated": "2026-11-20 18:21:20",
"avatar": null,
"person_data": {
"id": 54020,
"person_id": 56072,
"company_id": 1,
"email": "client2@example.com",
"phone": "+421900000002",
"date_of_birth": null,
"citizenship": null,
"created": "2026-11-20 18:21:20",
"updated": "2026-11-20 20:45:11"
}
},
"customer": {
"id": 56072,
"user_id": 65604,
"first_name": "Anna",
"last_name": "Novak",
"created": "2026-11-20 18:21:20",
"updated": "2026-11-20 18:21:20",
"avatar": null,
"person_data": {
"id": 54020,
"person_id": 56072,
"company_id": 1,
"email": "client2@example.com",
"phone": "+421900000002",
"date_of_birth": null,
"citizenship": null,
"created": "2026-11-20 18:21:20",
"updated": "2026-11-20 20:45:11"
}
},
"user": {
"id": 65604,
"first_name": "Anna",
"last_name": "Novak",
"email": "client2@example.com",
"phone": "+421900000002",
"feedback": true,
"created": "2026-11-20 18:21:20",
"updated": "2026-11-20 18:21:20",
"avatar": null,
"email_verified": false,
"email_verified_at": null,
"phone_verified": false,
"phone_verified_at": null,
"email_rejected": false
},
"pending_identity_claim": null,
"role": {
"id": 58644,
"company_id": 1,
"user_id": 65604,
"role": "customer",
"created": "2026-11-20 18:21:20",
"updated": "2026-11-20 18:21:20"
},
"linked_registrations": {
"total": 0,
"page": 0,
"page_size": 50,
"settings": {
"parent": 168321
},
"data": []
},
"application": {
"video": {
"id": 21,
"company_id": null,
"type": "video",
"url": "https://booking.example.com/",
"application_id": 2,
"options": {
"css": 1
},
"base_url": "example.com"
},
"profile": {
"id": 22,
"company_id": null,
"type": "profile",
"url": "https://booking.example.com/test123/profile",
"application_id": 2,
"options": {
"css": 0,
"show_payments": 1,
"show_event_number": 0,
"scroll_to_widget": 0,
"cancellation_reason": "none",
"attendance_type": "number",
"merge_rooms": 0,
"hide_total_debt": 0,
"show_qr_code": 1,
"open_course_booking_mode": "both"
},
"base_url": "example.com"
},
"registration": {
"id": 23,
"company_id": null,
"type": "registration",
"url": "https://booking.example.com/test123/registration",
"application_id": 2,
"options": {
"css": 1,
"scroll_to_widget": 0,
"hide_discounts": 0,
"merge_rooms": 1,
"hide_segmented_schedule_dates": 0,
"attendance_type": "text",
"submit_button_label": "register_with_payment",
"payment_schedule_price_display": "none",
"course_list_display": "grid",
"course_list_columns": 3
},
"base_url": "example.com"
},
"calendar": {
"id": 24,
"company_id": null,
"type": "calendar",
"url": "https://booking.example.com/calendar",
"application_id": 2,
"options": {
"registration": 1,
"more_information": 0,
"trainer": 0,
"merge_rooms": 1,
"group_places_by": "none",
"description": 0,
"duration": 0,
"click_settings": "registration",
"filter": 0,
"courses_filter": 0,
"course_types_filter": 0,
"places_filter": 0,
"trainers_filter": 0,
"toggle_filter": 0,
"attendance_type": "number",
"css": 1,
"events": 0,
"hide_preselected": 0,
"events_settings": "default",
"events_custom_settings": {
"current": false,
"future": true,
"unplanned": false,
"hide_if_full": false,
"as_calendar": true
}
},
"base_url": "example.com"
},
"checkout": {
"id": 25,
"company_id": null,
"type": "checkout",
"url": "https://booking.example.com/test123/checkout",
"application_id": 2,
"options": {
"css": 1
},
"base_url": "example.com"
},
"map": {
"id": 358,
"company_id": null,
"type": null,
"url": "https://booking.example.com/",
"application_id": 2,
"options": {
"css": 1,
"show_schedules": 1,
"age_filter": 1,
"show_price": 1,
"zip_code_filter": 1,
"radius_filter": 1,
"current_location": 1,
"navigate_label": "Navigate",
"show_navigate": 1
},
"base_url": "example.com"
}
},
"refund_requests": []
}
If the check refused it, the apply is refused too, with a 400. Here is a refused change applied anyway:
Applying a refused change: 400 0033 (reference)
PUT /v3/registrations/168321
{
"action": "change_status",
"status": "pre_registered"
}
Answer: 400
{
"errors": [
{
"0033": "Wrong parameters sent or parameters missing - Invalid status for registration [#1]."
}
],
"request_valid": false
}
Undoing a cancellation
You can change a cancelled registration's status again, but not always back to what it was. For example, after
pre_registered → canceled, the check refuses pre_registered and allows registered or waitlist. Check first:
Checking canceled → registered (reference)
PUT /v3/registrations/168321?action=preflight_check
{
"action": "change_status",
"status": "registered"
}
Answer: 200
Answer body (200)
{
"checks": {
"rules_hold": {
"name": "rules_hold",
"result": "passed",
"severity": "error"
},
"decision_missing": {
"name": "decision_missing",
"result": "passed",
"severity": "error"
},
"money_moves": {
"name": "money_moves",
"result": "passed",
"severity": "notice"
},
"transferred_money_stays": {
"name": "transferred_money_stays",
"result": "passed",
"severity": "notice"
},
"currency_conversion": {
"name": "currency_conversion",
"result": "passed",
"severity": "notice"
},
"status_allowed": {
"name": "status_allowed",
"result": "passed",
"severity": "error"
}
},
"properties": {
"result": {
"name": "result",
"value": {
"booking": {
"type": "registration",
"id": 168321
},
"root": {
"type": "registration",
"id": 168321
},
"limits": {
"max_depth": 3,
"truncated": false
},
"members": [
{
"type": "registration",
"id": 168321,
"summary": {
"name": "Ballet basics",
"client_name": "Anna Novak",
"course": {
"id": 990,
"name": "Kids gymnastics"
},
"schedule": {
"id": 6779,
"name": "Tuesday 17:00"
},
"product": null,
"status": "canceled",
"trial": false,
"balance": -110,
"currency": "EUR"
},
"parent": null,
"paid_by": null,
"pays_for": [],
"previous": null,
"next": null
}
],
"related": []
}
},
"transfers": {
"name": "transfers",
"value": []
},
"balances": {
"name": "balances",
"value": []
},
"refusals": {
"name": "refusals",
"value": []
},
"options": {
"name": "options",
"value": {}
}
}
}
Make-up credits cancelled with the registration don't come back.