Skip to main content
Make your first API call in 5 minutes. This guide helps you get up and running with TheGuarantors Embed API. It covers authentication, sandbox testing, and webhooks. The API lets you invite applicants, monitor their application status in real time, and manage the full lifecycle from invite to bond issuance.

Before you begin

You’ll need an API key. 📩 Email developer-support@theguarantors.com to get one. You can also subscribe to webhooks for real-time event notifications.

Authentication

TheGuarantors uses Basic Auth with an API key: send your API key as the username and leave the password blank. API keys are issued per environment, so use your sandbox key with https://api.sandbox.theguarantors.com and your live key with https://api.theguarantors.com. See Authentication for the header format and an example. 📩 Don’t have an API key? Email developer-support@theguarantors.com

Create your first invite

An invite is the entry point to TheGuarantors’ application flow. Creating one doesn’t notify your applicants. Instead, the response includes a unique link for each invite recipient, and you send each applicant their link so they can complete their application directly with TheGuarantors.
Once your applicant follows their link, TheGuarantors handles the bond application and underwriting process. Their application moves through these processes: Started → Submitted → Approved/Denied → Bond Issued You can subscribe to webhooks to get notified at each stage - no polling needed.

Sandbox & Testing

Use the sandbox to build and test your integration without touching live data. The sandbox is a near mirror of production, and you can manually trigger webhook events to simulate the entire lifecycle. See the full Sandbox Guide for further details.

More APIs coming soon

POST /v1/invites is the first of many endpoints available through our API platform. Watch the Changelog to stay up to date.

Need help?

See Contact Us for how to reach us, request an API key or a webhook subscription, and report an issue. 📩 developer-support@theguarantors.com