Developer API Integration - Back On Market Docs

Developer API Integration

Welcome to the BOMDocs Developer Center! Here you'll find everything you need to integrate our property‐report marketplace into your own applications.

Why Integrate with BOMDocs?

Our API allows you to search, purchase, and retrieve professional property reports (home inspections, appraisals, sewer scopes, and more) directly from your own software. Whether you’re building a real estate portal, CRM, or mobile app, BOMDocs powers a transparent, commission‐friendly marketplace behind the scenes.

Getting Started

  1. Create a Developer Account
    To access the BOMDocs API, you must first have a Developer Account. If you don’t already have one, sign up here and select the “Developer” role.
  2. Generate an API Key
    Once logged in as a Developer, navigate to My Account > API Keys and click “Create New Key.” Store the generated key securely—this is your credential for all subsequent calls.
  3. Review the Documentation
    Browse our full API reference at /docs/api. You’ll find a list of endpoints, required parameters, response schemas, and code samples (cURL, C#, JavaScript, etc.).
  4. Make Test Calls
    Use your API Key in the request header to try out endpoints. For example, to search for “Home Inspection” reports in cURL: 
    curl -X GET "https://api.bomdocs.com/reports/search?query=Home%20Inspection" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Accept: application/json"

Authentication & Security

Every request must include your API Key as a Bearer token in the Authorization header. Do not embed your key in client-side code or expose it publicly. Each key is tied to your Developer Account and can be revoked at any time from My Account > API Keys.

Example Header:
Authorization: Bearer <YOUR_API_KEY>

Available Endpoints

  • GET /reports/search?query={searchTerm} — Returns a list of available reports matching your search term.
  • GET /reports/{reportId} — Retrieves detailed metadata and download links for a specific report.
  • POST /reports/{reportId}/purchase — Initiates a purchase transaction for a given report (requires payment details in the request body).
  • GET /accounts/me — Returns your Developer Account profile, including current commission balance and active API keys.

Billing & Commission Rates

As a Developer, you can integrate BOMDocs into your applications and earn commissions on report purchases made through your integration. Here's how it works:

Commission Structure
  • Commission Rates: Commission rates for Developers are negotiable based on volume, integration type, and partnership level. Typical rates range from 10% to 20% of report purchase price.
  • Volume Discounts: Higher-volume integrations may qualify for preferred commission rates. Contact our sales team to discuss your specific needs.
  • Payouts: Commissions are tracked in your Developer dashboard and can be requested via payout once you reach the minimum threshold (typically $50).
API Usage & Billing
  • API Usage Tracking: All API calls are logged and tracked in your Developer dashboard, providing detailed analytics on endpoint usage, response times, and errors.
  • Billing Transparency: View your API usage, commission earnings, and payout history at any time through your account dashboard.
  • Rate Limits: Each API Key is limited to 150 requests per minute. Exceeding this will result in HTTP 429 (Too Many Requests). Enterprise accounts may negotiate higher rate limits.
Negotiate Your Rates

Commission rates and API access terms are negotiable. If you're building a high-volume integration or have specific requirements, please contact our sales team to discuss custom pricing and partnership terms.

Contact Sales About Rates

Developer Account Process

  1. Sign Up: Create an account and select the "Developer" role during registration.
  2. Approval: Developer accounts require admin approval. Once approved, you'll receive email notification and full access to the API.
  3. Generate API Keys: After approval, create API keys through your account dashboard.
  4. Review Documentation: Explore our comprehensive API documentation at /developers/docs.
  5. Start Building: Integrate BOMDocs into your applications and start earning commissions.

Rate Limits & Best Practices

• Each API Key is limited to 150 requests per minute. Exceeding this will result in HTTP 429 (Too Many Requests).
• Always cache search results for at least 60 seconds to reduce load.
• Handle errors gracefully and implement retry logic with exponential backoff.
• Monitor your API usage through the Developer dashboard to optimize performance.

Support & Contact

If you run into any issues, email our Developer Support at developers@bomdocs.com or contact us through our support form. We're here to help you ship quickly and securely.