curl https://liveohana.ai/api/v1/bookings/6f1c2a9e-3b4d-4e8f-9a1b-2c3d4e5f6a7b \
-H "Authorization: Bearer ohk_your_key_here"
const response = await fetch(
`https://liveohana.ai/api/v1/bookings/${bookingId}`,
{ headers: { Authorization: `Bearer ${process.env.OHANA_API_KEY}` } }
);
const { data: booking } = await response.json();
import os, requests
response = requests.get(
f"https://liveohana.ai/api/v1/bookings/{booking_id}",
headers={"Authorization": f"Bearer {os.environ['OHANA_API_KEY']}"},
)
booking = response.json()["data"]
{
"data": {
"id": "6f1c2a9e-3b4d-4e8f-9a1b-2c3d4e5f6a7b",
"reference": "L-48213",
"status": "upcoming",
"lease_status": "booked",
"payment_model": "stripe_whop_payouts",
"booked_at": "2026-08-14T17:02:11.000Z",
"move_in": "2026-11-01",
"move_out": "2027-01-31",
"nights": 91,
"canceled_at": null,
"listing": {
"id": "0b9f1a52-2d6e-4c7b-9a0e-6f2d4c1b8a33",
"title": "Sunny 1BR near Union Square"
},
"address": "450 Post St, Apt 5C, San Francisco, CA 94102",
"guest": {
"id": "a3e1d2c4-5b6f-4a7e-8d9c-0b1a2c3d4e5f",
"name": "Ada Lovelace",
"email": "ada@example.com",
"phone": "(555) 123-4567"
},
"earnings": { "amount": "7350.00", "currency": "USD" },
"security_deposit": { "amount": "1000.00", "currency": "USD" },
"updated_at": "2026-10-20T09:15:42.000Z",
"signed_agreement_available": true,
"payouts": [
{
"id": "c2d3e4f5-a6b7-4c8d-9e0f-1a2b3c4d5e6f",
"type": "rent_payout",
"period_start": "2026-11-01",
"period_end": "2026-11-30",
"scheduled_for": "2026-11-02",
"paid_at": null,
"amount": "2450.00",
"currency": "USD",
"status": "scheduled"
}
],
"security_deposit_refunds": []
}
}
{
"error": {
"code": "not_found",
"message": "No booking with that id."
}
}
Bookings
Retrieve a booking
Get one booking, with guest contact details, payouts, and deposit refunds.
GET
/
api
/
v1
/
bookings
/
{id}
curl https://liveohana.ai/api/v1/bookings/6f1c2a9e-3b4d-4e8f-9a1b-2c3d4e5f6a7b \
-H "Authorization: Bearer ohk_your_key_here"
const response = await fetch(
`https://liveohana.ai/api/v1/bookings/${bookingId}`,
{ headers: { Authorization: `Bearer ${process.env.OHANA_API_KEY}` } }
);
const { data: booking } = await response.json();
import os, requests
response = requests.get(
f"https://liveohana.ai/api/v1/bookings/{booking_id}",
headers={"Authorization": f"Bearer {os.environ['OHANA_API_KEY']}"},
)
booking = response.json()["data"]
{
"data": {
"id": "6f1c2a9e-3b4d-4e8f-9a1b-2c3d4e5f6a7b",
"reference": "L-48213",
"status": "upcoming",
"lease_status": "booked",
"payment_model": "stripe_whop_payouts",
"booked_at": "2026-08-14T17:02:11.000Z",
"move_in": "2026-11-01",
"move_out": "2027-01-31",
"nights": 91,
"canceled_at": null,
"listing": {
"id": "0b9f1a52-2d6e-4c7b-9a0e-6f2d4c1b8a33",
"title": "Sunny 1BR near Union Square"
},
"address": "450 Post St, Apt 5C, San Francisco, CA 94102",
"guest": {
"id": "a3e1d2c4-5b6f-4a7e-8d9c-0b1a2c3d4e5f",
"name": "Ada Lovelace",
"email": "ada@example.com",
"phone": "(555) 123-4567"
},
"earnings": { "amount": "7350.00", "currency": "USD" },
"security_deposit": { "amount": "1000.00", "currency": "USD" },
"updated_at": "2026-10-20T09:15:42.000Z",
"signed_agreement_available": true,
"payouts": [
{
"id": "c2d3e4f5-a6b7-4c8d-9e0f-1a2b3c4d5e6f",
"type": "rent_payout",
"period_start": "2026-11-01",
"period_end": "2026-11-30",
"scheduled_for": "2026-11-02",
"paid_at": null,
"amount": "2450.00",
"currency": "USD",
"status": "scheduled"
}
],
"security_deposit_refunds": []
}
}
{
"error": {
"code": "not_found",
"message": "No booking with that id."
}
}
Returns a single booking on your host profile. It has every field from List bookings, plus the guest’s contact details, your payouts, and security deposit refunds.
A booking that doesn’t exist, or belongs to another host profile, returns
404 not_found.
Path parameters
string
required
The booking
id.Response
Booking detail
required
Every Booking field, with these additions:
Show Additional fields
Show Additional fields
object
required
boolean
required
Whether a signed lease agreement PDF is available for this booking in your dashboard.
Payout[]
required
Payouts from Ohana to you for this booking, earliest first by scheduled date.
Show Payout
Show Payout
string
required
Payout ID.
string
required
rent_payout for rent, or security_deposit_to_host for a security deposit claim paid to you.string | null
First day of the rent period this payout covers,
YYYY-MM-DD. null for deposit claims.string | null
Last day of the rent period this payout covers,
YYYY-MM-DD. null for deposit claims.string | null
The date the payout is scheduled,
YYYY-MM-DD.string | null
When the payout was sent. ISO 8601 timestamp.
string | null
Net amount after any deductions, as a decimal string.
string | null
ISO 4217 currency code.
string | null
draft, scheduled, pending, in_transit, paid, canceled, or failed.Deposit refund[]
required
Refunds of the guest’s security deposit.
Show Deposit refund
Show Deposit refund
string
required
Refund ID.
string | null
When the deposit was collected. ISO 8601 timestamp.
string | null
The last day to file a deposit claim before the refund goes to the guest,
YYYY-MM-DD.string | null
When the refund was processed. ISO 8601 timestamp.
string | null
Amount refunded to the guest, as a decimal string.
string
required
Always
USD.string | null
draft, scheduled, pending, requires_action, succeeded, failed, or canceled.curl https://liveohana.ai/api/v1/bookings/6f1c2a9e-3b4d-4e8f-9a1b-2c3d4e5f6a7b \
-H "Authorization: Bearer ohk_your_key_here"
const response = await fetch(
`https://liveohana.ai/api/v1/bookings/${bookingId}`,
{ headers: { Authorization: `Bearer ${process.env.OHANA_API_KEY}` } }
);
const { data: booking } = await response.json();
import os, requests
response = requests.get(
f"https://liveohana.ai/api/v1/bookings/{booking_id}",
headers={"Authorization": f"Bearer {os.environ['OHANA_API_KEY']}"},
)
booking = response.json()["data"]
{
"data": {
"id": "6f1c2a9e-3b4d-4e8f-9a1b-2c3d4e5f6a7b",
"reference": "L-48213",
"status": "upcoming",
"lease_status": "booked",
"payment_model": "stripe_whop_payouts",
"booked_at": "2026-08-14T17:02:11.000Z",
"move_in": "2026-11-01",
"move_out": "2027-01-31",
"nights": 91,
"canceled_at": null,
"listing": {
"id": "0b9f1a52-2d6e-4c7b-9a0e-6f2d4c1b8a33",
"title": "Sunny 1BR near Union Square"
},
"address": "450 Post St, Apt 5C, San Francisco, CA 94102",
"guest": {
"id": "a3e1d2c4-5b6f-4a7e-8d9c-0b1a2c3d4e5f",
"name": "Ada Lovelace",
"email": "ada@example.com",
"phone": "(555) 123-4567"
},
"earnings": { "amount": "7350.00", "currency": "USD" },
"security_deposit": { "amount": "1000.00", "currency": "USD" },
"updated_at": "2026-10-20T09:15:42.000Z",
"signed_agreement_available": true,
"payouts": [
{
"id": "c2d3e4f5-a6b7-4c8d-9e0f-1a2b3c4d5e6f",
"type": "rent_payout",
"period_start": "2026-11-01",
"period_end": "2026-11-30",
"scheduled_for": "2026-11-02",
"paid_at": null,
"amount": "2450.00",
"currency": "USD",
"status": "scheduled"
}
],
"security_deposit_refunds": []
}
}
{
"error": {
"code": "not_found",
"message": "No booking with that id."
}
}