Marketplace API Documentation

Proximity Protect — COI Integration API v1

v1.0

Overview

The Proximity Protect Marketplace API allows partner platforms to issue Certificates of Insurance (COIs) for daily workspace rentals in real-time.

Integration Approaches

Approach A: Partner Intake URL (Recommended)

Generate a signed URL → member clicks through → completes coverage on Protect → webhook fires back to you.

  1. 1 Assignment/membership requires coverage → your backend calls generate_url with member + building details.
  2. 2 We return a signed intake URL. You embed it in an email or redirect the member.
  3. 3 Member sees pre-filled info and clicks "Get Covered" or "Upload My COI".
  4. 4 On completion, we fire a webhook to your callback URL with status + coverage details.
  5. 5 You gate final approval on receiving the webhook (or poll the Status Widget endpoint).

Approach B: Direct API (Full Automation)

Call our Submit Reservation endpoint directly with booking details → we generate a COI instantly → return a secure coi_view_url in the response + fire a webhook.

Base URL

https://app.base44.com/api/apps/6992788d996e6139db52a454/functions

All endpoints accept POST requests with JSON bodies.

Key Design Principles

  • • Dynamic COI Links — We return a secure view URL, not the raw PDF. The PDF is only fetched when the link is clicked.
  • • Idempotent — Submitting the same marketplace_reservation_id twice returns the existing COI rather than creating a duplicate.
  • • Webhook + Sync — COI details are returned in the API response AND delivered to your webhook.
  • • Geo-restricted — API calls are limited to US-based IPs.