Peerspace API

POST https://cotlet.dev/api/v1/peerspace/list_listings

Returns every listing on your host account with its space, base rate, whether Instant Book is on and whether the listing is live or paused. A paused listing cannot be booked and is hidden from search, and guests cannot contact you about it. Use the IDs here in the other calls.

Parameters

No parameters.

Request

curl -X POST https://cotlet.dev/api/v1/peerspace/list_listings \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("peerspace", "list_listings")

const result = await cotlet.call('peerspace', 'list_listings');

cotlet call peerspace list_listings

Example response

{
  "listings": [
    {
      "listing_id": "l_30918",
      "space_id": "s_4410",
      "title": "Daylight loft studio",
      "base_hourly_rate": 120,
      "instant_book": false,
      "status": "live"
    },
    {
      "listing_id": "l_30922",
      "space_id": "s_4410",
      "title": "Daylight loft, events",
      "base_hourly_rate": 150,
      "instant_book": false,
      "status": "paused"
    }
  ]
}

POST https://cotlet.dev/api/v1/peerspace/list_bookings

Lists bookings and requests, each with guest first name, start and end, attendees and the status. Requests carry an expires_at, two business days after you received them, so your agent can answer the oldest first. Use booking_id with get_booking, accept_booking_request and decline_booking_request.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/peerspace/list_bookings \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("peerspace", "list_bookings")

const result = await cotlet.call('peerspace', 'list_bookings');

cotlet call peerspace list_bookings

Example response

{
  "bookings": [
    {
      "booking_id": "b_90417",
      "listing_id": "l_30918",
      "guest": "Dana",
      "status": "requested",
      "start": "2026-10-17T14:00:00-07:00",
      "end": "2026-10-17T18:00:00-07:00",
      "attendees": 12,
      "expires_at": "2026-10-14T09:12:00-07:00"
    }
  ],
  "next_cursor": null
}

POST https://cotlet.dev/api/v1/peerspace/get_booking

Returns the full record of one booking or request, including the add-ons attached, the price and the payout you expect after Peerspace's service fee. For a request it also returns when it expires. Read it before you accept or decline.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/peerspace/get_booking \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"booking_id":"booking_8c41d2"}'

result = client.call("peerspace", "get_booking", {"booking_id":"booking_8c41d2"})

const result = await cotlet.call('peerspace', 'get_booking', {"booking_id":"booking_8c41d2"});

cotlet call peerspace get_booking --data '{"booking_id":"booking_8c41d2"}'

Example response

{
  "booking_id": "b_90417",
  "listing_id": "l_30918",
  "guest": "Dana",
  "status": "requested",
  "start": "2026-10-17T14:00:00-07:00",
  "end": "2026-10-17T18:00:00-07:00",
  "attendees": 12,
  "activity": "Photo shoot",
  "add_ons": [
    {
      "name": "Backdrop set",
      "price": 50
    }
  ],
  "subtotal": 480,
  "total": 530,
  "expected_payout": 477,
  "expires_at": "2026-10-14T09:12:00-07:00"
}

POST https://cotlet.dev/api/v1/peerspace/list_conversations

Lists your Peerspace inbox threads, each linked to an inquiry or a booking. Set unanswered_only to get only threads where the guest wrote last, which is what response rate is measured on. Pass next_cursor back as cursor for the next page.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/peerspace/list_conversations \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("peerspace", "list_conversations")

const result = await cotlet.call('peerspace', 'list_conversations');

cotlet call peerspace list_conversations

Example response

{
  "conversations": [
    {
      "conversation_id": "c_58210437",
      "guest": "Dana",
      "about": "inquiry",
      "last_message_at": "2026-10-11T08:40:00-07:00",
      "guest_wrote_last": true
    }
  ],
  "next_cursor": null
}

POST https://cotlet.dev/api/v1/peerspace/get_conversation

Returns the whole thread, oldest message first, with the inquiry or booking it is about. Your agent reads it before replying so it does not repeat an earlier answer.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/peerspace/get_conversation \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conversation_id":"conversation_8c41d2"}'

result = client.call("peerspace", "get_conversation", {"conversation_id":"conversation_8c41d2"})

const result = await cotlet.call('peerspace', 'get_conversation', {"conversation_id":"conversation_8c41d2"});

cotlet call peerspace get_conversation --data '{"conversation_id":"conversation_8c41d2"}'

Example response

{
  "conversation_id": "c_58210437",
  "about": "inquiry",
  "messages": [
    {
      "from": "guest",
      "sent_at": "2026-10-11T08:40:00-07:00",
      "body": "Hi! Is parking free, and can we shoot on Oct 24?"
    }
  ]
}

POST https://cotlet.dev/api/v1/peerspace/get_calendar

Returns what the Peerspace calendar shows for one space between two dates: inquiries, requests and bookings. Inquiries and requests do not block the time, so it still looks open to guests; accepted bookings do. Check it before you accept a request.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/peerspace/get_calendar \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"space_id":"space_8c41d2","from":"2026-10-01","to":"2026-10-01"}'

result = client.call("peerspace", "get_calendar", {"space_id":"space_8c41d2","from":"2026-10-01","to":"2026-10-01"})

const result = await cotlet.call('peerspace', 'get_calendar', {"space_id":"space_8c41d2","from":"2026-10-01","to":"2026-10-01"});

cotlet call peerspace get_calendar --data '{"space_id":"space_8c41d2","from":"2026-10-01","to":"2026-10-01"}'

Example response

{
  "space_id": "s_4410",
  "days": [
    {
      "date": "2026-10-17",
      "items": [
        {
          "type": "request",
          "booking_id": "b_90417",
          "start": "14:00",
          "end": "18:00"
        }
      ]
    },
    {
      "date": "2026-10-18",
      "items": [
        {
          "type": "booking",
          "booking_id": "b_90388",
          "start": "10:00",
          "end": "13:00"
        }
      ]
    }
  ]
}

POST https://cotlet.dev/api/v1/peerspace/list_payouts

Lists the payouts from your payout dashboard. A payout is scheduled 72 hours after the booking ends, becomes processing once initiated and processed after it is paid out. Each entry lists what is inside it, because the payout for a booking and for its overtime can arrive separately.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/peerspace/list_payouts \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("peerspace", "list_payouts")

const result = await cotlet.call('peerspace', 'list_payouts');

cotlet call peerspace list_payouts

Example response

{
  "payouts": [
    {
      "payout_id": "p_7710",
      "status": "scheduled",
      "date": "2026-10-20",
      "amount": 842.5,
      "includes": [
        {
          "type": "booking",
          "booking_id": "b_90388",
          "amount": 800
        },
        {
          "type": "overtime",
          "booking_id": "b_90388",
          "amount": 42.5
        }
      ]
    }
  ]
}

POST https://cotlet.dev/api/v1/peerspace/send_message

Sends a message in an existing thread under your name; the guest gets it in the Peerspace inbox. It cannot start a thread with a stranger, only answer one. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/peerspace/send_message \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conversation_id":"c_58210437","body":"Hi Dana, Oct 24 is open for 20 people. Parking for 6 cars is free on site, and load-in is through the back door on 3rd St. Want me to send you an offer for the hours you need?"}'

result = client.call("peerspace", "send_message", {"conversation_id":"c_58210437","body":"Hi Dana, Oct 24 is open for 20 people. Parking for 6 cars is free on site, and load-in is through the back door on 3rd St. Want me to send you an offer for the hours you need?"})

const result = await cotlet.call('peerspace', 'send_message', {"conversation_id":"c_58210437","body":"Hi Dana, Oct 24 is open for 20 people. Parking for 6 cars is free on site, and load-in is through the back door on 3rd St. Want me to send you an offer for the hours you need?"});

cotlet call peerspace send_message --data '{"conversation_id":"c_58210437","body":"Hi Dana, Oct 24 is open for 20 people. Parking for 6 cars is free on site, and load-in is through the back door on 3rd St. Want me to send you an offer for the hours you need?"}'

Example response

{
  "message_id": "m_6204188",
  "conversation_id": "c_58210437",
  "status": "sent",
  "sent_at": "2026-10-11T09:05:00-07:00"
}

POST https://cotlet.dev/api/v1/peerspace/send_custom_offer

Sends an invite-to-book from a guest thread. Spaces without a food and beverage minimum take a rental fee; spaces with one also take minimum spend and gratuity. Sales tax on minimum spend and add-ons is added automatically, so do not include it. The guest then has 7 days to review and submit payment. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/peerspace/send_custom_offer \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conversation_id":"c_58210437","start":"2026-10-24T10:00:00-07:00","end":"2026-10-24T16:00:00-07:00","attendees":20,"rental_fee":900,"note":"Six hours for your team offsite, setup from 9:30."}'

result = client.call("peerspace", "send_custom_offer", {"conversation_id":"c_58210437","start":"2026-10-24T10:00:00-07:00","end":"2026-10-24T16:00:00-07:00","attendees":20,"rental_fee":900,"note":"Six hours for your team offsite, setup from 9:30."})

const result = await cotlet.call('peerspace', 'send_custom_offer', {"conversation_id":"c_58210437","start":"2026-10-24T10:00:00-07:00","end":"2026-10-24T16:00:00-07:00","attendees":20,"rental_fee":900,"note":"Six hours for your team offsite, setup from 9:30."});

cotlet call peerspace send_custom_offer --data '{"conversation_id":"c_58210437","start":"2026-10-24T10:00:00-07:00","end":"2026-10-24T16:00:00-07:00","attendees":20,"rental_fee":900,"note":"Six hours for your team offsite, setup from 9:30."}'

Example response

{
  "offer_id": "o_7731905",
  "conversation_id": "c_58210437",
  "status": "sent",
  "rental_fee": 900,
  "expires_at": "2026-10-18T09:05:00-07:00"
}

POST https://cotlet.dev/api/v1/peerspace/accept_booking_request

Accepts a request from the Bookings tab. The booking is confirmed and the guest's card is charged for the full amount. A request you leave alone expires after two business days. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/peerspace/accept_booking_request \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"booking_id":"b_90417"}'

result = client.call("peerspace", "accept_booking_request", {"booking_id":"b_90417"})

const result = await cotlet.call('peerspace', 'accept_booking_request', {"booking_id":"b_90417"});

cotlet call peerspace accept_booking_request --data '{"booking_id":"b_90417"}'

Example response

{
  "booking_id": "b_90417",
  "status": "confirmed",
  "start": "2026-10-17T14:00:00-07:00",
  "end": "2026-10-17T18:00:00-07:00",
  "total": 530
}

POST https://cotlet.dev/api/v1/peerspace/decline_booking_request

Declines a request. The authorization hold on the guest's card is released. Declining counts as a response for your response rate, an expired request does not. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/peerspace/decline_booking_request \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"booking_id":"booking_8c41d2"}'

result = client.call("peerspace", "decline_booking_request", {"booking_id":"booking_8c41d2"})

const result = await cotlet.call('peerspace', 'decline_booking_request', {"booking_id":"booking_8c41d2"});

cotlet call peerspace decline_booking_request --data '{"booking_id":"booking_8c41d2"}'

Example response

{
  "booking_id": "b_90421",
  "status": "declined"
}

POST https://cotlet.dev/api/v1/peerspace/request_booking_update

Sends an update request on a confirmed booking; the guest accepts or declines. If they accept, the change applies at once. If they decline, or do not answer within two business days, the original booking stays. If you change the hours, set the new price yourself: it does not update on its own, and 8+ hour discounts do not apply to host updates. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/peerspace/request_booking_update \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"booking_id":"booking_8c41d2","fields":"fields"}'

result = client.call("peerspace", "request_booking_update", {"booking_id":"booking_8c41d2","fields":"fields"})

const result = await cotlet.call('peerspace', 'request_booking_update', {"booking_id":"booking_8c41d2","fields":"fields"});

cotlet call peerspace request_booking_update --data '{"booking_id":"booking_8c41d2","fields":"fields"}'

Example response

{
  "booking_id": "b_90388",
  "update_id": "u_2045",
  "status": "pending_guest",
  "fields": {
    "end": "2026-10-18T14:00:00-07:00",
    "subtotal": 800
  }
}

POST https://cotlet.dev/api/v1/peerspace/block_calendar_time

Blocks the time for all guests, including guests with a pending inquiry or offer. The title is a private reminder that guests cannot see. There is no call to unblock. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/peerspace/block_calendar_time \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"space_id":"space_8c41d2","start":"2026-10-01T09:00:00Z","end":"2026-10-01T09:00:00Z"}'

result = client.call("peerspace", "block_calendar_time", {"space_id":"space_8c41d2","start":"2026-10-01T09:00:00Z","end":"2026-10-01T09:00:00Z"})

const result = await cotlet.call('peerspace', 'block_calendar_time', {"space_id":"space_8c41d2","start":"2026-10-01T09:00:00Z","end":"2026-10-01T09:00:00Z"});

cotlet call peerspace block_calendar_time --data '{"space_id":"space_8c41d2","start":"2026-10-01T09:00:00Z","end":"2026-10-01T09:00:00Z"}'

Example response

{
  "block_id": "blk_5531",
  "space_id": "s_4410",
  "start": "2026-11-03T00:00:00-08:00",
  "end": "2026-11-03T23:59:00-08:00",
  "title": "Maintenance"
}

POST https://cotlet.dev/api/v1/peerspace/add_calendar_rate

Adds a calendar rate to one listing: a name, a rate and the days and times it applies to. Guests see it at checkout once they enter start and end times. Rates far above your base rate can hurt conversion, and Peerspace may remove accounts that use rates to mislead guests. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/peerspace/add_calendar_rate \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listing_id":"listing_8c41d2","name":"Jane Doe","hourly_rate":1,"days":["days"]}'

result = client.call("peerspace", "add_calendar_rate", {"listing_id":"listing_8c41d2","name":"Jane Doe","hourly_rate":1,"days":["days"]})

const result = await cotlet.call('peerspace', 'add_calendar_rate', {"listing_id":"listing_8c41d2","name":"Jane Doe","hourly_rate":1,"days":["days"]});

cotlet call peerspace add_calendar_rate --data '{"listing_id":"listing_8c41d2","name":"Jane Doe","hourly_rate":1,"days":["days"]}'

Example response

{
  "listing_id": "l_30918",
  "rate_id": "r_8802",
  "name": "Weekend",
  "hourly_rate": 150,
  "days": [
    "sat",
    "sun"
  ]
}

POST https://cotlet.dev/api/v1/peerspace/set_instant_book

Switches the Instant Book toggle for one listing. If the toggle is not available on the listing, the call fails and you need to use Request Access in Peerspace first. You can turn it on or off at any time. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/peerspace/set_instant_book \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listing_id":"listing_8c41d2","enabled":true}'

result = client.call("peerspace", "set_instant_book", {"listing_id":"listing_8c41d2","enabled":True})

const result = await cotlet.call('peerspace', 'set_instant_book', {"listing_id":"listing_8c41d2","enabled":true});

cotlet call peerspace set_instant_book --data '{"listing_id":"listing_8c41d2","enabled":true}'

Example response

{
  "listing_id": "l_30918",
  "instant_book": true
}