> ## Documentation Index
> Fetch the complete documentation index at: https://docs.liveohana.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve a booking

> Get one booking, with guest contact details, payouts, and deposit refunds.

Returns a single booking on your host profile. It has every field from [List bookings](https://docs.liveohana.ai/api-reference/bookings/list.md), 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

**id** `string` *required*

The booking `id`.

## Response

**data** `Booking detail` *required*

Every [Booking](https://docs.liveohana.ai/api-reference/bookings/list.md#response) field, with these additions:

**Additional fields**

**guest** `object` *required*

The list fields `id` and `name`, plus:

**properties**

**email** `string | null`

Guest's email address.

**phone** `string | null`

Guest's primary phone number.

**signed\_agreement\_available** `boolean` *required*

Whether a signed lease agreement PDF is available for this booking in your dashboard.

**payouts** `Payout[]` *required*

Payouts from Ohana to you for this booking, earliest first by scheduled date.

**Payout**

**id** `string` *required*

Payout ID.

**type** `string` *required*

`rent_payout` for rent, or `security_deposit_to_host` for a security deposit claim paid to you.

**period\_start** `string | null`

First day of the rent period this payout covers, `YYYY-MM-DD`. `null` for deposit claims.

**period\_end** `string | null`

Last day of the rent period this payout covers, `YYYY-MM-DD`. `null` for deposit claims.

**scheduled\_for** `string | null`

The date the payout is scheduled, `YYYY-MM-DD`.

**paid\_at** `string | null`

When the payout was sent. ISO 8601 timestamp.

**amount** `string | null`

Net amount after any deductions, as a decimal string.

**currency** `string | null`

ISO 4217 currency code.

**status** `string | null`

`draft`, `scheduled`, `pending`, `in_transit`, `paid`, `canceled`, or `failed`.

**security\_deposit\_refunds** `Deposit refund[]` *required*

Refunds of the guest's security deposit.

**Deposit refund**

**id** `string` *required*

Refund ID.

**received\_at** `string | null`

When the deposit was collected. ISO 8601 timestamp.

**claim\_deadline** `string | null`

The last day to file a deposit claim before the refund goes to the guest, `YYYY-MM-DD`.

**refunded\_at** `string | null`

When the refund was processed. ISO 8601 timestamp.

**amount** `string | null`

Amount refunded to the guest, as a decimal string.

**currency** `string` *required*

Always `USD`.

**status** `string | null`

`draft`, `scheduled`, `pending`, `requires_action`, `succeeded`, `failed`, or `canceled`.

```bash cURL theme={null}
curl https://liveohana.ai/api/v1/bookings/6f1c2a9e-3b4d-4e8f-9a1b-2c3d4e5f6a7b \
  -H "Authorization: Bearer ohk_your_key_here"
```

```javascript Node.js theme={null}
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();
```

```python Python theme={null}
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"]
```

```json 200 theme={null}
{
  "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": []
  }
}
```

```json 404 theme={null}
{
  "error": {
    "code": "not_found",
    "message": "No booking with that id."
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.