Ingest API

The push direction: your site tells Hostwise about bookings and add-ons it created and settled itself — so they appear in the account's back office (reservations list, multi-calendar, cleaning schedule, reporting) alongside everything else. Where the Gateway API is "book through Hostwise", Ingest is "record in Hostwise".

POST/api/ingest

Authenticated with your OAuth 2.1 Bearer token (see Authentication), ingest scope. The body carries one booking in your brand's shape:

{
  "brand": "yourbrand",
  "confirmation_code": "YB-4F7K2",            // YOUR stable reference — the idempotency key
  "listing_id": "…",                          // Hostwise listingId where applicable
  "check_in": "2027-01-10", "check_out": "2027-01-17",
  "guests": 4,
  "guest": { "name": "…", "email": "…", "phone": "…" },
  "money": { "total": 2240, "currency": "EUR" },
  "status": "confirmed",
  "payment": {
    "method": "single",                       // "single" | "split" (per-guest shares)
    "complete": true,                         // false while shares are still being collected
    "paid": 3, "of": 6, "label": "3/6",       // split progress (omit for single)
    "card_brand": "visa",                     // card summary, shown on the reservation's Payments tab
    "card_last4": "4242",                     //   exactly 4 digits — never send a full card number
    "paid_at": "2027-01-03T18:22:00Z",        // when the charge succeeded
    "url": "https://payments.example.com/…"          // deep link to YOUR payment record (https only)
  },
  "addons": [ { "type": "transfer", "external_id": "YB-4F7K2-T1", "guest_name": "…", "start_date": "2027-01-10",
                "amount_cents": 15000, "currency": "EUR",
                "items": [ { "id": 52, "qty": 1 } ],       // the partner's menu items sold (from /api/storefront/partners)
                "quote_id": "q-8812",                      // a live-priced item: the quote you booked at checkout
                "details": { "airport": "GVA" } } ]
}

Selling partner services. Hostwise tells your site what the account can sell (/api/storefront/partners); you sell it and push the add-on here naming the menu items (and the quote_id of a live item). Hostwise prices the partner's side from its menu or the quote, opens the request to the partner, and the partner confirms in its portal or from its own system. The type is the partner's kind (transfer, rental, pass); any other type is recorded for the account's own ledger.

The response carries the guest's reservation number

Take the payment first, then push the booking here. The response returns the reservation number to show your guest:

{
  "ok": true,
  "reservation": "ok",
  "reservation_number": "YB-29BED6D3",        // show THIS to the guest, store it on your booking
  "reservation_id": 4821
}
The full add-on schema (per-guest ski passes, rentals, transfers with flight details) is richer than this page. Ask your account manager for the ingest schema supplement for your vertical — the shapes above cover the booking envelope every integration shares.