Skip to content
Quikstik Developers

Read booking intent

GET
/booking-intents/{booking_intent_id}
curl --request GET \
  --url https://quikstik-core.fly.dev/booking-intents/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'x-tenant-id: 2489E9AD-2EE2-8E00-8EC9-32D5F69181C0'

Reads a booking intent by id.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
booking_intent_id
required
string format: uuid

Header Parameters

Section titled “Header Parameters”
x-tenant-id
required
string format: uuid

Tenant identifier (UUID).

Authn/authz semantics are intentionally TBD for this contract slice; this header exists to keep the contract explicitly multi-tenant from day 0.

Responses

Section titled “Responses”

200

Section titled “200”

Booking intent

Media typeapplication/json
object
booking_intent_id
required
string format: uuid
offering_variant_id
required
string format: uuid
departure_id

The departure (capacity leaf,) this hold bound to at creation, resolved server-side from (tenant, offering_variant_id, start_time). The purchase leg commits this leaf directly. Null only for an unscheduled hold (no start_time).

string format: uuid
nullable
created_at_ms
required

Unix epoch milliseconds.

integer format: int64
status
required

Intent status (vocabulary only). This contract slice does not define lifecycle execution. Examples: created, cancel_requested.

string
start_time
string
nullable
duration_minutes
integer
nullable
quantity
integer
nullable
group_id
string format: uuid
nullable
participants
Array<object>
nullable
object
participant_id
required

Participant identifier (stable within commerce). Creation/identity semantics are TBD.

string format: uuid
display_name
string
nullable
birth_date

Birth date (YYYY-MM-DD). Optional; semantics TBD.

string
nullable
payer_hints
Array<object>
nullable
object
payer_id
required

Payer identifier (vocabulary only; does not imply payment execution).

string format: uuid
covers_participant_ids

Optional linkage for “payer covers subset of participants” (vocabulary only).

Array<string>
nullable
affiliate_attribution
object
kind
required

Attribution kind (vocabulary only; semantics TBD).

string
affiliate_id

Affiliate identifier (TBD).

string
nullable
referral_code
string
nullable
campaign
string
nullable
seller_tenant_id
string format: uuid
nullable
fulfilling_tenant_id
string format: uuid
nullable
add_on_selections
Array<object>
nullable
object
add_on_id
required
string format: uuid
quantity
required
integer
>= 1

Example generated

{
  "booking_intent_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "offering_variant_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "departure_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "created_at_ms": 1,
  "status": "example",
  "start_time": "example",
  "duration_minutes": 1,
  "quantity": 1,
  "group_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "participants": [
    {
      "participant_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "display_name": "example",
      "birth_date": "example"
    }
  ],
  "payer_hints": [
    {
      "payer_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "covers_participant_ids": [
        "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
      ]
    }
  ],
  "affiliate_attribution": {
    "kind": "example",
    "affiliate_id": "example",
    "referral_code": "example",
    "campaign": "example"
  },
  "seller_tenant_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "fulfilling_tenant_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "add_on_selections": [
    {
      "add_on_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "quantity": 1
    }
  ]
}

404

Section titled “404”

Not found