List Estimates

GEThttps://backend.localbusiness.pro/api/v1/estimates

Returns a paginated list of estimates for the authenticated business, sorted by creation date (newest first).

X-Public-Keystringrequired

Your business public key. Used to identify which business is making the request.

X-Timestampstringrequired

Current Unix timestamp in seconds. Requests older than 5 minutes are rejected.

X-Signaturestringrequired

HMAC-SHA256 signature of the signing string: {timestamp}\n{METHOD}\n{path}\n{body}, using your private key as the secret.

pageinteger

Page number (1-indexed).

per_pageinteger

Items per page (max 100). Default: 25.

Values: 1-100

statusstring

Filter by estimate status (e.g., draft, sent, approved, declined, expired).

payment_statusstring

Filter by payment status (e.g., unpaid, partial, paid).

Responses

{
  "estimates": [
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "estimate_number": "EST-00015",
      "title": "Roof Replacement - 30-Year Architectural Shingles",
      "status": "sent",
      "payment_status": "unpaid",
      "subtotal": "14200.00",
      "discount_type": "percentage",
      "discount_value": "5.00",
      "tax_rate": "8.25",
      "tax_amount": "1112.15",
      "total_amount": "14602.15",
      "deposit_required": true,
      "deposit_amount": "3500.00",
      "amount_paid": "0.00",
      "expires_at": "2026-04-01T00:00:00.000000Z",
      "sent_at": "2026-03-01T12:00:00.000000Z",
      "approved_at": null,
      "created_at": "2026-02-28T09:30:00.000000Z",
      "updated_at": "2026-03-01T12:00:00.000000Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 25,
    "total_items": 15,
    "total_pages": 1
  }
}

Authentication — HMAC-SHA256

Every authenticated request requires three headers:

X-Public-KeyYour business public key

X-TimestampUnix timestamp (seconds)

X-SignatureHMAC-SHA256 of signing string

Signing string: {timestamp}\n{METHOD}\n{path}\n{body}

Request

GEThttps://backend.localbusiness.pro/api/v1/estimates

Rate Limits

With X-Public-Key: 60 req/min per key

Without: 10 req/min per IP

Code Examples

PUBLIC_KEY="pk_live_..."
PRIVATE_KEY="sk_live_..."
TIMESTAMP=$(date +%s)
PATH_URI="/api/v1/estimates?status=sent"

SIGNATURE=$(printf '%s\n%s\n%s\n' "$TIMESTAMP" "GET" "$PATH_URI" \
  | openssl dgst -sha256 -hmac "$PRIVATE_KEY" | awk '{print $2}')

curl -H "X-Public-Key: $PUBLIC_KEY" \
     -H "X-Timestamp: $TIMESTAMP" \
     -H "X-Signature: $SIGNATURE" \
     "https://backend.localbusiness.pro$PATH_URI"