Skip to content
Sanmopia Modernization

Start reservation booking workflow

Switch to Zen Mode
POST
/reservation-booking-workflow-starts
curl --request POST \
  --url https://example.com/reservation-booking-workflow-starts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "reservationBookingRequestId": "example", "branchProfileId": "example", "serviceOfferingKey": "example", "serviceAddressReferenceId": "example", "priceQuoteReference": "example", "motherProfile": { "memberId": "example", "email": "example", "name": "example", "phone": "example", "birthday": "example" }, "serviceAddress": { "sido": "example", "sigungu": "example", "bname": "example", "addressEvidenceSourceKind": "external_lookup", "zonecode": "example", "roadAddress": "example", "jibunAddress": "example", "addressLevelDetail": "example", "evidencePayloadFingerprint": "example" }, "branchContext": { "branchId": 1, "branchCode": "example", "branchName": "example", "headquartersId": 1, "branchOperatorId": 1, "caregiverIds": [ 1 ] }, "caregiverCandidates": [ { "caregiverId": 1, "name": "example", "distanceKm": 1, "availabilityWindows": [ { "startAt": "2026-04-15T12:00:00Z", "endAt": "2026-04-15T12:00:00Z" } ], "ratingScore": 1, "careerMonths": 1, "preferenceMatchScore": 1, "gradeCode": "example", "acceptsPetHousehold": true, "petAllergySpeciesCodes": [ "example" ] } ], "caregiverProfiles": [ { "caregiverId": "example", "active": true, "licenseTitles": [ "example" ], "trainingTopics": [ "example" ], "serviceAreas": [ { "addressLevel1": "example", "addressLevel2": "example", "addressLevel3": "example" } ], "unavailableWindows": [ { "startAt": "2026-04-15T12:00:00Z", "endAt": "2026-04-15T12:00:00Z" } ], "ratingScores": [ 1 ], "scoreByMember": 1 } ], "careEnvironment": { "pets": [ { "speciesCode": "example", "count": 1, "sizeCode": "example", "isolatedFromNewborn": true } ] }, "serviceStartAt": "2026-04-15T12:00:00Z", "serviceEndAt": "2026-04-15T12:00:00Z", "paymentMethodCode": "example", "serviceTypeDetailId": 1, "serviceDay": 1, "workingTypeId": 1, "serviceDayListId": 1, "reservationAmountHint": 1, "selectedCaregiverId": 1, "acceptedPriceCatalogQuote": { "catalogCode": "example", "versionLabel": "example", "entryCode": "example", "program": "voucher_care", "serviceTierCode": "example", "serviceTierName": "example", "serviceDayCount": 1, "quotedOn": "2026-04-15", "grossServiceAmountKrw": 1, "customerPayableAmountKrw": 1, "customerSubsidyAmountKrw": 1, "customerCreditAmountKrw": 1, "caregiverCompensationAmountKrw": 1, "branchSettlementAmountKrw": 1, "platformFeeAmountKrw": 1, "lines": [ { "componentCode": "example", "componentName": "example", "role": "customer_charge", "basis": "per_reservation", "amountKrw": 1, "quantity": 1 } ] }, "acceptedRegionalBenefitDecision": { "lines": [ { "benefitCode": "example", "displayName": "example", "amountComponentCode": "example", "amountComponentLabel": "example", "discountAmountKrw": 1, "regionalBenefitProfileKey": "example", "sourceEvidenceKey": "example", "serviceDayBonusCount": 1, "settlementParticipationCode": "example" } ] }, "acceptedServiceOfferingAvailabilityDecision": { "offeringKey": "example", "availabilityState": "available", "handoffKind": "pre_reservation_payment", "unavailableReasonCodes": [ "example" ], "messageKeys": [ "example" ], "policyRevisionKey": "example", "sourceEvidenceKeys": [ "example" ] }, "acceptedServiceTermPlan": { "policyKey": "example", "serviceStartOn": "2026-04-15", "duration": { "quantity": 1, "unit": "example", "serviceDaysPerWeek": 1, "durationProfileKey": "example", "serviceWeekProfile": { "profileKey": "example", "serviceDaysPerWeek": 1, "weekendWorkdayIndexes": [ 1 ], "sourceReference": "example" }, "sourceReference": "example" }, "serviceAreaKey": "example", "holidayRegistry": { "entries": [ { "holidayKey": "example", "calendarProfileKey": "example", "observedOn": "2026-04-15", "nonWorkingDayKind": "example", "serviceAvailableByDefault": true, "substituteOfHolidayKey": "example", "sourceReference": "example" } ] }, "serviceAreaProfiles": { "profiles": [ { "profileKey": "example", "serviceAreaKey": "example", "calendarProfileKey": "example", "effectiveFrom": "2026-04-15", "effectiveUntil": "2026-04-15", "nonWorkingWeekdays": [ 1 ], "durationExtensionDays": 1, "sourceReference": "example" } ] }, "selectedAdditionalServiceDays": [ { "selectionKey": "example", "serviceOn": "2026-04-15", "dayKind": "example", "sourceReference": "example", "chargeable": true } ], "sourceReference": "example" }, "bookingServiceTermSideEffects": { "acceptedServiceTermSnapshotKey": "example", "acceptedServiceTermSnapshotRevision": 1, "reservationServiceCalendarQuoteKey": "example", "reservationServiceCalendarQuoteRevision": 1, "selectedAddOptionSelectionKeys": [ "example" ], "addOptionChargeIntents": [ { "addOptionSelectionKey": "example", "chargeComponentCode": "example", "sourceEvidenceKeys": [ "example" ] } ], "consumerImpactFacts": [ { "impactFactKey": "example", "consumerContextCode": "example", "invalidationTargetCode": "example", "invalidationTargetReference": "example", "reasonCode": "example", "sourceProjectionKey": "example", "sourceEvidenceKeys": [ "example" ] } ], "requiredConsumerContextCodes": [ "example" ], "sourceEvidenceKeys": [ "example" ] } }'

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
ReservationBookingWorkflowStartInput
object
sponsoredReservationContractAcceptanceId
string | null
>= 1 characters
reservationBookingRequestId
required
string
>= 1 characters
branchProfileId
required
string
>= 1 characters
serviceOfferingKey
required
string
>= 1 characters
serviceAddressReferenceId
required
string
>= 1 characters
priceQuoteReference
required
string
>= 1 characters
motherProfile
required
object
memberId
required
string
>= 1 characters
email
required
string
>= 1 characters
name
required
string
>= 1 characters
phone
required
string
>= 1 characters
birthday
required
string
>= 1 characters
key
additional properties
serviceAddress
required
object
sido
required
string
>= 1 characters
sigungu
required
string | null
>= 1 characters
bname
required
string | null
>= 1 characters
addressEvidenceSourceKind
required
string
Allowed values: external_lookup operator_input legacy_import
zonecode
required
string | null
>= 1 characters
roadAddress
required
string | null
>= 1 characters
jibunAddress
required
string | null
>= 1 characters
addressLevelDetail
required
string | null
>= 1 characters
evidencePayloadFingerprint
required
string | null
>= 1 characters
key
additional properties
branchContext
required
object
branchId
required
integer
>= 1
branchCode
required
string
>= 1 characters
branchName
required
string
>= 1 characters
headquartersId
required
integer | null
>= 1
branchOperatorId
required
integer | null
>= 1
caregiverIds
required
Array<integer>
key
additional properties
caregiverCandidates
required
Array<object>
>= 1 items
object
caregiverId
required
integer
>= 1
name
required
string
>= 1 characters
distanceKm
required
number | null
availabilityWindows
required
Array<object>
object
startAt
required
string format: date-time
endAt
required
string format: date-time
key
additional properties
ratingScore
required
number
careerMonths
required
integer
preferenceMatchScore
required
number
gradeCode
required
string | null
>= 1 characters
acceptsPetHousehold
required
boolean
petAllergySpeciesCodes
required
Array<string>
key
additional properties
caregiverProfiles
required
Array<object>
>= 1 items
object
caregiverId
required
string
>= 1 characters
active
required
boolean
licenseTitles
required
Array<string>
trainingTopics
required
Array<string>
serviceAreas
required
Array<object>
object
addressLevel1
required
string
>= 1 characters
addressLevel2
required
string
>= 1 characters
addressLevel3
required
string
>= 1 characters
key
additional properties
unavailableWindows
required
Array<object>
object
startAt
required
string format: date-time
endAt
required
string format: date-time
key
additional properties
ratingScores
required
Array<number>
scoreByMember
required
number | null
key
additional properties
careEnvironment
required
object
pets
required
Array<object>
object
speciesCode
required
string
>= 1 characters
count
required
integer
>= 1
sizeCode
required
string | null
>= 1 characters
isolatedFromNewborn
required
boolean
key
additional properties
key
additional properties
serviceStartAt
required
string format: date-time
serviceEndAt
required
string format: date-time
paymentMethodCode
required
string
>= 1 characters
serviceTypeDetailId
required
integer
>= 1
serviceDay
required
integer
>= 1
workingTypeId
required
integer
>= 1
serviceDayListId
required
integer
>= 1
reservationAmountHint
required
integer
selectedCaregiverId
required
integer
>= 1
acceptedPriceCatalogQuote
required
object
catalogCode
required
string
>= 1 characters
versionLabel
required
string
>= 1 characters
entryCode
required
string
>= 1 characters
program
required
string
Allowed values: voucher_care private_care
serviceTierCode
required
string
>= 1 characters
serviceTierName
required
string
>= 1 characters
serviceDayCount
required
integer
>= 1
quotedOn
required
string format: date
grossServiceAmountKrw
required
integer
customerPayableAmountKrw
required
integer
customerSubsidyAmountKrw
required
integer
customerCreditAmountKrw
required
integer
caregiverCompensationAmountKrw
required
integer
branchSettlementAmountKrw
required
integer
platformFeeAmountKrw
required
integer
lines
required
Array<object>
>= 1 items
object
componentCode
required
string
>= 1 characters
componentName
required
string
>= 1 characters
role
required
string
Allowed values: customer_charge customer_subsidy customer_credit caregiver_compensation branch_settlement platform_fee
basis
required
string
Allowed values: per_reservation per_service_day per_effective_service_day per_extra_service_day per_hour rate_basis_points
amountKrw
required
integer
quantity
required
integer
>= 1
key
additional properties
key
additional properties
acceptedRegionalBenefitDecision
One of:
object
lines
required
Array<object>
object
benefitCode
required
string
>= 1 characters
displayName
required
string
>= 1 characters
amountComponentCode
required
string | null
>= 1 characters
amountComponentLabel
required
string | null
>= 1 characters
discountAmountKrw
required
integer
regionalBenefitProfileKey
required
string | null
>= 1 characters
sourceEvidenceKey
required
string | null
>= 1 characters
serviceDayBonusCount
required
integer
settlementParticipationCode
required
string | null
>= 1 characters
key
additional properties
key
additional properties
acceptedServiceOfferingAvailabilityDecision
required
object
offeringKey
required
string
>= 1 characters
availabilityState
required
string
Allowed values: available unavailable
handoffKind
required
string
Allowed values: pre_reservation_payment caregiver_search service_detail_selection service_detail_command unavailable
unavailableReasonCodes
Array<string>
messageKeys
Array<string>
policyRevisionKey
required
string
>= 1 characters
sourceEvidenceKeys
required
Array<string>
>= 1 items
key
additional properties
acceptedServiceTermPlan
One of:
object
policyKey
required
string
>= 1 characters
serviceStartOn
required
string format: date
duration
required
object
quantity
required
integer
>= 1
unit
required
string
>= 1 characters
serviceDaysPerWeek
required
integer
>= 1 <= 7
durationProfileKey
required
string | null
>= 1 characters
serviceWeekProfile
required
One of:
object
profileKey
required
string
>= 1 characters
serviceDaysPerWeek
required
integer
>= 1 <= 7
weekendWorkdayIndexes
required
Array<integer>
sourceReference
required
string | null
>= 1 characters
key
additional properties
sourceReference
required
string | null
>= 1 characters
key
additional properties
serviceAreaKey
required
string
>= 1 characters
holidayRegistry
required
object
entries
required
Array<object>
object
holidayKey
required
string
>= 1 characters
calendarProfileKey
required
string
>= 1 characters
observedOn
required
string format: date
nonWorkingDayKind
required
string
>= 1 characters
serviceAvailableByDefault
required
boolean
substituteOfHolidayKey
required
string | null
>= 1 characters
sourceReference
required
string | null
>= 1 characters
key
additional properties
key
additional properties
serviceAreaProfiles
required
object
profiles
required
Array<object>
>= 1 items
object
profileKey
required
string
>= 1 characters
serviceAreaKey
required
string
>= 1 characters
calendarProfileKey
required
string
>= 1 characters
effectiveFrom
required
string format: date
effectiveUntil
required
string | null format: date
nonWorkingWeekdays
required
Array<integer>
durationExtensionDays
required
integer
sourceReference
required
string | null
>= 1 characters
key
additional properties
key
additional properties
selectedAdditionalServiceDays
required
Array<object>
object
selectionKey
required
string
>= 1 characters
serviceOn
required
string format: date
dayKind
required
string
>= 1 characters
sourceReference
required
string | null
>= 1 characters
chargeable
required
boolean
key
additional properties
sourceReference
required
string | null
>= 1 characters
key
additional properties
bookingServiceTermSideEffects
One of:
object
acceptedServiceTermSnapshotKey
required
string
>= 1 characters
acceptedServiceTermSnapshotRevision
required
integer
>= 1
reservationServiceCalendarQuoteKey
required
string
>= 1 characters
reservationServiceCalendarQuoteRevision
required
integer
>= 1
selectedAddOptionSelectionKeys
required
Array<string>
addOptionChargeIntents
required
Array<object>
object
addOptionSelectionKey
required
string
>= 1 characters
chargeComponentCode
required
string
>= 1 characters
sourceEvidenceKeys
required
Array<string>
>= 1 items
key
additional properties
consumerImpactFacts
required
Array<object>
object
impactFactKey
required
string
>= 1 characters
consumerContextCode
required
string
>= 1 characters
invalidationTargetCode
required
string
>= 1 characters
invalidationTargetReference
required
string
>= 1 characters
reasonCode
required
string
>= 1 characters
sourceProjectionKey
required
string
>= 1 characters
sourceEvidenceKeys
required
Array<string>
>= 1 items
key
additional properties
requiredConsumerContextCodes
required
Array<string>
>= 1 items
sourceEvidenceKeys
required
Array<string>
>= 1 items
key
additional properties

Responses

Section titled “Responses”

202

Section titled “202”

Reservation booking workflow accepted

Media typeapplication/json
ReservationBookingWorkflowStartResponse
object
workflowStateEngine
required
string
Allowed value: restate
workflowName
required
string
Allowed value: ReservationBookingWorkflow
workflowKey
required
string
/^reservation-booking:.+/
handlerName
required
string
Allowed value: run
invocationId
required
string
>= 1 characters
workflowStatus
required
string
Allowed values: requested accepted running completed failed cancelled
reservationBookingRequestId
required
string | null
>= 1 characters
key
additional properties

401

Section titled “401”

Supabase bearer token is required

403

Section titled “403”

Actor cannot submit reservation booking request

503

Section titled “503”

Reservation booking workflow runtime is unavailable