Bond

application_id

string

required

Example:

"sd_01HQ8Z"

bond_number

string

required

Example:

"TG-2026-004182"

coverage

object

required

Defines the amount of rent and/or security deposit replacement for the surety bond.

Show child attributes

string

required

Example:

"bond_01HQAB"

last_updated

string<date-time>

required

Example:

"2026-03-15T14:15:22Z"

lease

object

required

The legal contract between a property manager and the tenant. A lease agreement contains information about the property, the address and duration of the lease, and financial terms like rent amount and security deposit information. Leases map 1:1 with TheGuarantors surety bonds. A single lease can have one or more applicants.

Show child attributes

object

string

required

Example:

"bond"

principals

object[]

required

Show child attributes

property_id

string

required

Example:

"prop_01HQ7A"

status

enum<string>

required

Available options:

issued,

canceled

Example:

"issued"

document_link

string | null

A URL that returns the bond's PDF with a plain GET. No API key is needed. The link is long-lived; if one ever stops working, fetch the bond again for a fresh link. Treat it as private, and don't parse or build it yourself. null when no PDF exists yet.

Downloading bond PDFs

Status	Meaning
`200`	The bond's PDF, returned as `application/pdf`.
`403`	The link is invalid.
`404`	No PDF exists for this bond yet.
`502`, `504`	The PDF couldn't be fetched right now. Try again later.

Example:

"https://api.theguarantors.com/v1/bonds/bond_7f29djw82kdpq9sl/document?token=v1.xxxxx"

metadata

object | null

Key-value object. Use this field to include internal references, identifiers, or any additional data that helps link this lease to your internal system. Each key must be a string, and values can be strings, numbers, booleans, or null.

obligee

string | null

The party that will be the obligee/claimant on the surety bond. This can be a limited liability company (LLC), a property management company, the property name, or the legal name of a sole proprietor owner.

Example:

"Rivermark Residential LLC"

penal_sum

integer | null

The maximum amount payable under the bond in cents. Calculated as monthly_rent*(lg_num_months_covered + sdr_num_months_covered)

Example:

560000

premium

integer | null

The amount charged to the tenant for the bond in cents.

Example:

42000

⌘I

{
  "application_id": "sd_01HQ8Z",
  "bond_number": "TG-2026-004182",
  "coverage": {
    "lease_guarantee": {
      "coverage_amount": 1,
      "coverage_unit": "months"
    },
    "object": "coverage",
    "security_deposit_replacement": {
      "coverage_amount": 1,
      "coverage_unit": "months"
    }
  },
  "id": "bond_01HQAB",
  "last_updated": "2026-03-15T14:15:22Z",
  "lease": {
    "monthly_rent": 280000,
    "object": "lease",
    "unit_address": {
      "city": "Brooklyn",
      "line1": "412 Halsey St",
      "object": "address",
      "postal_code": "11233",
      "state": "NY",
      "line2": "Apt 3R"
    },
    "end_date": "2027-08-31",
    "start_date": "2026-09-01"
  },
  "object": "bond",
  "principals": [
    {
      "applicant_id": "applc_01HQ9A",
      "email": "dana.whitfield@example.com",
      "first_name": "Dana",
      "last_name": "Whitfield",
      "object": "principal",
      "phone_number": "+15551234567"
    }
  ],
  "property_id": "prop_01HQ7A",
  "status": "issued",
  "document_link": "https://api.theguarantors.com/v1/bonds/bond_7f29djw82kdpq9sl/document?token=v1.xxxxx",
  "metadata": {},
  "obligee": "Rivermark Residential LLC",
  "penal_sum": 560000,
  "premium": 42000
}

Application API

Schemas