DeedPro API

Quickstart

Three steps from a key to a recordable PDF.

1. 1. Get a test key. Request access — three fields, no account needed. We issue keys after a short conversation about what you’re building. Test keys start with dp_test_.
2. 2. POST the transaction. One request carries the property, the parties, the transfer tax declaration, and the recording block.
3. 3. Download the PDF. The response includes an authenticated PDF URL and a public verification URL.

curl -X POST https://deedpro-main-api.onrender.com/api/v1/deeds \
  -H "Authorization: Bearer dp_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-48219" \
  -d '{
    "deed_type": "grant_deed",
    "property": {
      "address": "1234 Sycamore Lane",
      "city": "Los Angeles",
      "state": "CA",
      "zip": "90001",
      "county": "Los Angeles",
      "apn": "5432-001-012",
      "legal_description": "LOT 15, BLOCK 3, TRACT 12345, IN THE CITY OF LOS ANGELES..."
    },
    "grantor": { "name": "JOHN A. DOE AND JANE B. DOE, HUSBAND AND WIFE" },
    "grantee": { "name": "ROBERT C. ROE", "vesting": "a single man" },
    "transfer_tax": {
      "exempt": false,
      "value": 750000,
      "computed_amount": "825.00",
      "basis": "full_value",
      "city_tax": true,
      "city_name": "Los Angeles"
    },
    "recording": {
      "requested_by": "Pacific Coast Escrow",
      "title_order_no": "TO-88231",
      "escrow_no": "ESC-44120",
      "return_to": {
        "name": "ROBERT C. ROE",
        "address": "1234 Sycamore Lane",
        "city": "Los Angeles",
        "state": "CA",
        "zip": "90001"
      }
    }
  }'

{
  "success": true,
  "data": {
    "deed_id": "deed_8Kd2mQxR4vLp",
    "document_id": "DOC-2026-H7K3M",
    "deed_type": "grant_deed",
    "status": "completed",
    "created_at": "2026-08-03T18:22:41Z",
    "urls": {
      "pdf": ".../api/v1/deeds/deed_8Kd2mQxR4vLp/pdf",
      "verification": ".../verify/DOC-2026-H7K3M"
    },
    "property": { "address": "1234 Sycamore Lane, Los Angeles, CA 90001", ... },
    "parties": { "grantor": "JOHN A. DOE AND JANE B. DOE", "grantee": "ROBERT C. ROE" },
    "transfer_tax": { "amount": "$825.00", "exempt": false }
  }
}

Python

import requests

resp = requests.post(
    "https://deedpro-main-api.onrender.com/api/v1/deeds",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Idempotency-Key": order_id,   # safe to retry
    },
    json=deed_payload,
    timeout=60,                        # PDFs render server-side
)
resp.raise_for_status()
deed = resp.json()["data"]

pdf = requests.get(deed["urls"]["pdf"],
                   headers={"Authorization": f"Bearer {API_KEY}"})
open(f"{deed['document_id']}.pdf", "wb").write(pdf.content)

Node

const res = await fetch("https://deedpro-main-api.onrender.com/api/v1/deeds", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
    "Idempotency-Key": orderId,   // safe to retry
  },
  body: JSON.stringify(deedPayload),
});

if (!res.ok) {
  const { detail } = await res.json();
  throw new Error(`${detail.code}: ${detail.message}`);
}

const { data } = await res.json();

Authentication

Every request carries your key as a bearer token:

Authorization: Bearer dp_live_...

• Test and live keys. dp_test_ and dp_live_. Both generate real PDFs on the same templates; test keys exist so you can build and demo without your traffic mixing into live records.
• Shown once. Keys are stored hashed. The full value appears exactly once, when it is created — if it is lost, we issue a new one rather than recovering the old.
• Rate limits. Per-key hourly and daily ceilings. Responses carry X-RateLimit-Limit and X-RateLimit-Remaining; exceeding one returns 429. Tell us your expected volume and we will set the ceiling to match.
• Revocation. A key can be deactivated at any time; calls with it stop immediately and return 403.

Deed types

Nine instruments, each rendered from its own template. The vesting column is worth reading closely: two instruments state their vesting on their own face, and for those the API rejects a supplied value rather than ignoring it.

What the API will not do

Worth reading before you integrate, and worth handing to your counsel.

Idempotency & retries

A deed is a legal instrument, and a retried request must not produce a second one. Send an Idempotency-Key header — your order or file number works well — and a repeat with the same key returns the original deed instead of generating a duplicate.

Idempotency-Key: order-48219

Keys are scoped to your API key. PDF rendering happens server-side, so allow a generous timeout (60s) and retry with the same idempotency key rather than a fresh one.

Errors

Errors carry a stable code and a message meant to be actionable.

{
  "detail": {
    "code": "RATE_LIMITED",
    "message": "Hourly rate limit exceeded"
  }
}

Transfer tax

POST /transfer-tax/calculate returns a county and city breakdown for a value and location. It is a convenience for populating your own declaration — the amount that prints on the deed is the one you send in transfer_tax.

• County rate: $1.10 per $1,000 (R&T §11911).
• City rates apply only to cities that levy their own documentary transfer tax. A city that levies none is reported as levying none — the endpoint does not apply a generic rate.
• City rates are approximations of tiered municipal schedules. Verify against the current schedule for the recording jurisdiction; the response carries this caveat alongside the number.

Versioning & changelog

The current version is v1, covering the deed family. Additive changes — new deed types, new optional fields, new response keys — ship within v1 without notice. A breaking change would ship under a new path (/api/v2), and v1 would keep working; we will not repurpose a field or change what an existing one means underneath you.